《在 Spring Boot 中安全使用 Qwen API-KEY：环境变量替代明文配置的最佳实践》

《在 Spring Boot 中安全使用 Qwen API-KEY：环境变量替代明文配置的最佳实践》

想要的效果其实就是 把 Qwen API-KEY 放到系统环境变量中，然后在 application.yml 里通过占位符读取，而不写明文。
这样即便 application.yml 被提交到 Git，也不会泄露 key。

分成三个步骤搞定：

1. 在系统中设置 Qwen API-KEY

假设真实的API-KEY是sk-12asdadba01231231b6a5asda9d7d

Mac / Linux

# 临时生效（只对当前终端会话有效）
export QWEN_API_KEY=sk-12asdadba01231231b6a5asda9d7d

# 永久生效（写入 shell 配置文件，比如 ~/.bashrc 或 ~/.zshrc）
echo 'export QWEN_API_KEY=sk-12asdadba01231231b6a5asda9d7d' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）

# 临时生效（仅当前会话）
$env:QWEN_API_KEY="sk-12asdadba01231231b6a5asda9d7d"

# 永久生效
setx QWEN_API_KEY "sk-12asdadba01231231b6a5asda9d7d"

2. 在 application.yml 中引用环境变量

qwen:
  api-key: ${QWEN_API_KEY}

• ${QWEN_API_KEY} 会从系统环境变量中读取值
• 如果想给默认值（避免本地没设置时报错）：

qwen:
  api-key: ${QWEN_API_KEY:default-key-if-not-set}

3. 在 Spring Boot 中读取

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class QwenConfig {
    @Value("${qwen.api-key}")
    private String apiKey;

    public String getApiKey() {
        return apiKey;
    }
}

这样 Spring Boot 启动时会自动读取系统的环境变量 QWEN_API_KEY，
application.yml 就不需要暴露明文了。

💡 补充建议
如果你部署在服务器（比如 Docker / K8s），可以在启动容器时直接传环境变量：

docker run -e QWEN_API_KEY=sk-12asdadba01231231b6a5asda9d7d my-springboot-app

读取 环境变量 → application.yml → 默认值 的。

4. 注意

如果启动IDEA，发现读取不到设置的环境变量的话，可以先用羡慕这行命令读取环境变量，看看是否生效了。

echo $QWEN_API_KEY

如果这个时候仍然没有获取到内容，但是去~/.zshrc下可以查看到对应的值的话，原因就是当时已经打开过IDEA了，这个时候读取不到设置的环境变量，需要重新退出IDEA，然后重新打开去输入上述命令查看。