一、问题描述
1、异常信息
shell
org.springframework.ai.retry.NonTransientAiException: HTTP 404 - No response body available
at org.springframework.ai.retry.autoconfigure.SpringAiRetryAutoConfiguration$2.handleError(SpringAiRetryAutoConfiguration.java:109) ~[spring-ai-autoconfigure-retry-1.0.0.jar:1.0.0]
at org.springframework.web.client.ResponseErrorHandler.handleError(ResponseErrorHandler.java:58) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.StatusHandler.lambda$fromErrorHandler$1(StatusHandler.java:71) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.StatusHandler.handle(StatusHandler.java:146) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.DefaultRestClient$DefaultResponseSpec.applyStatusHandlers(DefaultRestClient.java:838) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.DefaultRestClient$DefaultResponseSpec.lambda$readBody$4(DefaultRestClient.java:827) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.DefaultRestClient.readWithMessageConverters(DefaultRestClient.java:216) ~[spring-web-6.2.10.jar:6.2.10]
at org.springframework.web.client.DefaultRestClient$DefaultResponseSpec.readBody(DefaultRestClient.java:826) ~[spring-web-6.2.10.jar:6.2.10]2、应用场景
- 调用通义万相文生图
二、解决办法
1、解决步骤
AI 分析
这个 NonTransientAiException 错误提示表明 Spring AI 在调用大模型服务时，收到了 HTTP 404 状态码，且服务器没有返回任何错误信息。这意味着请求的地址无法被找到。
结合常见的 Spring AI 使用场景，这通常不是代码逻辑的错误，而是配置或网络环境的问题。以下是几个主要排查方向：
🔑 检查 API 基础地址 (Base URL)
这是最常见的原因。你需要确认配置文件（如 application.yml 或 application.properties）中指定的 API 地址是否正确。
- 检查拼写错误：仔细核对 URL 的拼写，确保没有多余的字符或缺少路径。
- 确认版本路径 ：许多大模型服务的 API 地址中包含版本号（例如
/v1/,/api/v1/），请确保你使用的地址与服务提供商的最新文档一致。 - 区分本地与远程 ：
- 如果你调用的是远程云服务（如 OpenAI, 阿里云百炼等），请登录对应平台，从控制台获取正确的 endpoint 地址。
- 如果你调用的是本地部署 的大模型服务（如 Ollama, LM Studio, Open WebUI 等），请确保服务已启动，并且 URL 指向的是本地地址（如
http://localhost:11434/api）。
🌐 检查网络连接与代理
如果你确定 URL 没有拼写错误，那么可能是网络层面的问题。
- 网络连通性：如果你在公司内网或使用了 VPN，可能无法直接访问外部的 API 地址。请检查网络设置，尝试关闭 VPN 或配置代理。
- 代理配置：如果必须通过代理访问外网，请在 Java 启动参数或代码中正确配置 HTTP 代理。
🛠️ 检查模型名称
在某些情况下，如果请求的模型名称 (model name) 在服务端不存在，服务端也可能返回 404 而不是更具体的 400 错误。
- 请检查你的配置，确保
spring.ai.chat.options.model（或其他类似配置项）的值是服务端支持的、完全正确的模型名称。例如，不要将qwen-plus错误地写成qwen。
💡 如何快速定位？
最有效的方法是开启 HTTP 客户端的调试日志，查看 Spring AI 实际发出的完整请求地址。
在 application.yml 中添加：
yaml
logging:
level:
org.springframework.web.client: DEBUG启动应用后，仔细查看控制台输出的 Request URL，复制这个完整的 URL 到浏览器或 Postman 中直接访问，观察返回结果，这能帮你最直观地判断是地址错了还是网络不通。