java调用通义千问需五步：一配api密钥与okhttp/jackson依赖；二建带超时、拦截器的http客户端；三封装同步/异步服务类；四处理sse流式响应与token截断；五集成springboot自动配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Java项目中调用通义千问大模型服务，但尚未建立稳定、可复用的HTTP通信链路，则可能是由于API凭证缺失、请求格式不匹配或客户端配置不当所致。以下是实现通义千问Java接口调用与项目集成的具体操作步骤：
一、配置API密钥与基础依赖
该步骤确保Java应用具备合法身份并拥有发起HTTP请求与解析JSON响应的能力。密钥需安全注入，避免硬编码；依赖需覆盖网络通信、序列化及异常处理等核心环节。
1、登录阿里云DashScope控制台，进入“API密钥管理”，创建新AccessKey，获取AccessKeyId与AccessKeySecret；
2、将密钥以环境变量形式注入运行时：执行export DASHSCOPE_API_KEY=sk-xxxxxx（Linux/macOS）或set DASHSCOPE_API_KEY=sk-xxxxxx（Windows）；
3、在pom.xml中添加以下Maven依赖：
二、构建标准化HTTP客户端
该步骤封装可复用的OkHttpClient实例，统一设置超时、连接池与拦截器，避免每次请求重复初始化，提升并发稳定性与可观测性。
1、新建QwenHttpClient.java类，在静态块中初始化全局OkHttpClient；
2、设置连接超时为30秒、读取超时为60秒、写入超时为60秒；
3、添加请求头拦截器，自动注入Authorization: Bearer ${apiKey}与Content-Type: application/json；
4、启用日志拦截器（仅开发环境），记录完整请求URL、方法、请求体与响应状态码；
三、封装模型调用服务类
该步骤定义清晰的输入输出契约，将原始HTTP调用抽象为面向业务的方法，屏蔽底层协议细节，支持同步阻塞与异步非阻塞两种调用模式。
1、定义QwenRequest类，包含model（如qwen-max）、input.messages（List
2、定义QwenResponse类，映射JSON响应中的output.text、usage.total_tokens、request_id等关键字段；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
3、在服务类中提供syncGenerate(String prompt)方法，内部调用OkHttpClient执行POST并反序列化响应；
4、提供asyncGenerate(String prompt, Consumer<qwenresponse> callback)</qwenresponse>方法，使用enqueue()实现回调式异步处理；
四、处理流式响应与长文本截断
该步骤应对通义千问API返回SSE（Server-Sent Events）格式的流式数据场景，避免因单次响应过大或超时导致连接中断，确保长对话内容完整接收。
1、判断API端点是否启用流式模式（如URL含?stream=true或请求体含"stream": true）；
2、使用OkHttp的EventSource或自定义ResponseBody.source()逐行读取data: {...}事件；
3、对每条data行进行JSON解析，提取output.text片段并拼接至StringBuilder；
4、当检测到data: [DONE]或响应流关闭时，触发完成回调，并校验usage.total_tokens是否超出模型最大上下文限制8192 tokens；
五、集成SpringBoot自动配置与属性绑定
该步骤使通义千问客户端成为Spring容器内可注入的Bean，支持通过application.yml集中管理API地址、超时、默认模型等参数，便于多环境部署。
1、创建QwenProperties.java类，使用@ConfigurationProperties("qwen.api")绑定配置前缀；
2、在application.yml中声明：
qwen:
api:
endpoint: https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
model: qwen-plus
connect-timeout-millis: 30000
read-timeout-millis: 60000
3、编写QwenAutoConfiguration.java，声明@Bean QwenService qwenService(QwenProperties props, OkHttpClient client)；
4、在业务Controller中通过@Autowired private QwenService qwenService直接调用，无需手动构造客户端；
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
