复制粘贴 Spring AI 官方示例跑不通？这 3 个坑，老张替你踩过了

首发长文发完有读者问老张“代码我拷了依赖我也加了为啥还是跑不通”老张一看多半是这 3 个坑。坑 1版本号不对API 全变样Spring AI 还在快速迭代。你搜到的博客可能是半年前的用的是旧 API。老张团队验证过的稳定组合Spring Boot3.4.xSpring AI1.0.1Spring AI Alibaba1.0.0.4特别注意ChatMemory.get(userId)在 1.0.1 里不再接受lastN参数QuestionAnswerAdvisor也升级成了RetrievalAugmentationAdvisor。你用 1.1.x 草稿版代码对不上教程会崩溃。坑 2API Key 直接写死在代码里初学者图省事把百炼 Key 贴在application.yml里提交到 Git。老张的做法开发环境用环境变量生产环境走配置中心或密钥管理服务。spring:ai:dashscope:api-key:${DASHSCOPE_API_KEY:}本地启动时这样带DASHSCOPE_API_KEYsk-xxxx ./mvnw spring-boot:run坑 3流式返回前端没接住后端写了stream().content()前端还是用普通 POST 请求。结果要么是乱码要么是只收到最后一个字。老张提醒流式要配 SSE 或 WebFluxFluxString前端用 EventSource 逐段渲染。同步和流式是两套调用方式别混着用。完整代码、分支、跑通步骤都在 GitHubhttps://github.com/yinclei/SpringAITutorial 互动你跑 Spring AI 时还踩过哪些坑评论区留下老张下篇统一答疑。