Spring Boot 项目集成 ChatGPT API 通常通过调用 OpenAI 提供的 REST 接口实现，因为官方未发布 Java SDK。

推荐使用社区维护的 openai-gpt3-java 库简化 HTTP 请求构造，需注意 API Key 保密及网络连通性风险。

快速处理思路

集成过程主要涉及 Maven 依赖引入、配置文件密钥设置以及 Service 层代码封装。

<dependency>
    <groupId>com.theokanning.openai-gpt3-java</groupId>
    <artifactId>service</artifactId>
    <version>0.18.0</version>
</dependency>

在 application.yml 中配置密钥，避免硬编码在代码里。

openai:
  api-key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

为什么会这样

OpenAI 官方仅提供 REST API 规范，未维护特定语言的 SDK。

Java 开发者通常使用 Retrofit 或 HttpClient 自行调用，社区库 openai-gpt3-java 基于 Retrofit 封装了常用接口，能减少样板代码。这种模式适用于所有非官方支持语言，优点是灵活，缺点是需自行维护依赖库的版本兼容性。

分步处理

第一步是引入依赖，确认 Maven 仓库能下载该社区库。

第二步是配置密钥，通过 @Value 注解读取 application.yml 中的 openai.api-key 字段。

第三步是创建配置类，实例化 OpenAiService 对象，设置超时时间防止请求挂起。

@Configuration
public class OpenAiConfig {
    @Value("${openai.api-key}")
    private String apiKey;

    @Bean
    public OpenAiService openAiService() {
        return new OpenAiService(apiKey, 30);
    }
}

第四步是编写 Service 业务逻辑，调用 chatCompletion 方法发送消息。

第五步是 Controller 层暴露接口，接收前端参数并返回模型响应。

怎么验证是否生效

查看应用启动日志，确认 OpenAiService Bean 已成功初始化。

调用后端接口后，检查控制台是否有 HTTP 200 状态码日志。

确认返回内容包含 choices 字段且 message 不为空，表示模型已生成回复。

若出现 401 错误，说明 API Key 无效或格式错误；若出现 Connect Timeout，说明网络无法到达 api.openai.com。

常见坑

API Key 泄露风险高，严禁提交到 Git 仓库，建议使用环境变量或配置中心管理。

默认超时时间可能过短，大模型生成耗时较长，建议设置 30 秒以上超时。

模型名称可能变更，代码中硬编码 gpt-3.5-turbo 需定期确认是否仍受支持。

社区 SDK 更新频率不一，生产环境需锁定具体版本号，避免自动升级导致接口不兼容。

常见问题

API Key 应该放在哪里最安全？

建议放在服务器环境变量或 Kubernetes Secret 中，不要写在代码仓库里。

调用失败报 403 错误是什么原因？

通常是网络环境限制或账号区域限制，需确认请求来源 IP 是否在允许范围内。

如何切换不同的模型版本？

在构建 ChatCompletionRequest 时指定 model 参数，例如 gpt-4 或 gpt-3.5-turbo。

参考来源

OpenAI Platform API Documentation, https://platform.openai.com/docs/api-reference

theokanning/openai-gpt3-java GitHub Repository, https://github.com/TheOkanning/openai-gpt3-java