<think>
我们正在处理一个
Spring AI应用中的HTTP 400错误，具体错误信息是：
`org
.springframework
.ai.retry
.NonTransient
AiException: HTTP 400
- {"requestId":"e7086b88
-920b
-97cf
-b5a0
-5b325342240f","code":"InvalidParameter","message":"No static resource
api-open
ai/v1/embeddings/
api/v1/services/embeddings/text
-embedding/text
-embedding
."}`
错误信息表明，我们请求的URL路径不正确。从错误消息中可以看出，请求的URL路径为：`
api-open
ai/v1/embeddings/
api/v1/services/embeddings/text
-embedding/text
-embedding`，这显然是一个拼接错误的路径。
在
Spring AI中，当我们使用Open
AI的嵌入功能时，我们需要正确配置基础URL和
API路径。通常，Open
AI的嵌入
API的路径应该是`/v1/embeddings`，但这里出现了重复的路径段。
根据错误信息，我们可能错误地配置了基础URL（base URL）和
API路径（
api path），导致两者被拼接在一起形成了无效的路径。
### 常见的配置属性
在
Spring AI中，与Open
AI相关的配置属性通常以`
spring.ai.open
ai`为前缀。关键的配置属性包括：
- `
spring.ai.open
ai.base
-url`: 用于设置Open
AI API的基础URL，默认是`https://
api.open
ai.com`。
- `
spring.ai.open
ai.embedding
.options
.model`: 设置嵌入模型，例如`text
-embedding
-ada
-002`。
- `
spring.ai.open
ai.embedding
.options
.api`: 设置
API路径，但通常我们不需要设置这个，因为默认值是正确的。
### 错误原因分析
从错误信息中的路径`
api-open
ai/v1/embeddings/
api/v1/services/embeddings/text
-embedding/text
-embedding`可以看出，这个路径由多个部分组成，其中包含了重复的部分。这可能是由于我们在配置基础URL时包含了部分路径（例如，配置了`base
-url`为`http://your
-host/
api-open
ai`），同时又设置了
API路径（可能是默认的或手动设置的`/v1/embeddings`），然后
Spring AI在构造请求URL时进行了错误的拼接。
实际上，如果我们查看
Spring AI的源代码，它构造请求URL的方式是：
```
String url = baseUrl + "/" +
apiPath;
```
因此，如果`baseUrl`已经包含了路径，再拼接上`
apiPath`就会形成重复。
### 解决方案
为了解决这个问题，我们需要检查我们的配置文件（如`application
.properties`或`application
.yml`）中的相关配置。
1
. **检查基础URL（base
-url）**：确保`
spring.ai.open
ai.base
-url`只包含协议、主机和端口（如果需要），而不包含
API路径部分。例如：
```properties
spring.ai.open
ai.base
-url=https://
api.open
ai.com
```
2
. **检查
API路径（
api）**：通常情况下，我们不需要设置
API路径，因为
Spring AI提供了默认值。但是，如果我们自定义了
API路径，确保它不包含基础URL中已有的部分。默认的嵌入
API路径是`/v1/embeddings`。
3
. **完整配置示例**：
```properties
# Open
AI API密钥
spring.ai.open
ai.api-key=YOUR_
API_KEY
# 基础URL（如果是使用官方Open
AI，则不需要设置，因为默认就是这个）
# 如果使用代理或自己部署的兼容Open
AI API的服务，则设置正确的基础URL（不包含路径部分）
spring.ai.open
ai.base
-url=https://
api.open
ai.com
# 嵌入模型设置
spring.ai.open
ai.embedding
.options
.model=text
-embedding
-ada
-002
```
4
. **如果使用的是Azure Open
AI**：那么配置会有所不同，因为Azure Open
AI的
API路径格式不同。例如：
```properties
spring.ai.open
ai.api-type=azure
spring.ai.open
ai.base
-url=https://{your
-resource
-name}
.open
ai.azure
.com
spring.ai.open
ai.api-key={your
-api-key}
spring.ai.open
ai.embedding
.options
.model={deployment
-name} # 部署的嵌入模型名称
spring.ai.open
ai.embedding
.options
.api=open
ai/deployments/{deployment
-name}/embeddings?
api-version={
api-version}
```
注意：在Azure Open
AI的情况下，
API路径需要按照Azure的要求设置。
### 针对当前错误的调整
根据错误信息中的路径，我们推测配置可能是这样的：
- `base
-url`可能被设置成了`http://somehost/
api-open
ai/v1/embeddings`（或包含了`
api-open
ai`等路径）
- 而
API路径可能被设置成了`
api/v1/services/embeddings/text
-embedding/text
-embedding`
我们需要将`base
-url`调整为不包含
API路径的部分，同时将
API路径调整为正确的值。
例如，如果我们使用的是官方的Open
AI服务，那么：
- 将`
spring.ai.open
ai.base
-url`设置为`https://
api.open
ai.com`
- 移除任何自定义的
API路径配置（使用默认的`/v1/embeddings`）
如果我们使用的是其他服务（比如自己部署的Open
AI API兼容服务），那么：
- 确保`base
-url`指向服务的主机，例如`http://localhost:8080`
- 然后设置正确的
API路径，例如`/v1/embeddings`（具体取决于服务提供的路径）
### 验证
调整配置后，重新启动应用，验证是否解决了问题。
### 总结
这个错误通常是由于错误的基础URL和
API路径配置导致的。请检查并调整这两个配置项，确保它们正确且不重复。
§§相关问题§§
1
. Spring AI中如何配置Azure Open
AI服务？
2
. 除了路径配置错误，还有哪些原因会导致
Spring AI中的HTTP 400错误？
3
. 如何在
Spring AI中自定义重试机制以处理暂时性错误？
</think>
### 解决 `org
.springframework
.ai.retry
.NonTransient
AiException: HTTP 400` 错误的分析与方案
#### **错误原因分析**
1
. **URL 路径配置错误**：
- 错误信息明确提示 `No static resource
api-open
ai/v1/embeddings/
api/v1/services/embeddings/text
-embedding/text
-embedding`。
- 这表明
Spring AI 发送的请求 URL 路径无效，可能是配置文件中拼接了重复路径（如 `
api-open
ai/v1/embeddings` + `/
api/v1/services/
...`）。
- 典型错误配置示例：
```properties
# 错误示例：路径重复
spring.ai.open
ai.base
-url=https://your
-host/
api-open
ai/v1/embeddings
spring.ai.open
ai.embedding
.options
.api=/
api/v1/services/embeddings/text
-embedding
```
2
. **端点格式不兼容**：
- Open
AI 的标准 Embeddings
API 端点为 `/v1/embeddings`。
- 错误中的路径 `
api/v1/services/embeddings/text
-embedding/text
-embedding` 不符合 Open
AI 官方格式，可能是自定义服务路径未正确配置。
3
. **可能涉及 Azure Open
AI**：
- Azure Open
AI 的路径格式为 `/open
ai/deployments/{deployment}/embeddings?
api-version={version}`，若使用 Azure 服务需特殊配置[^1]。
---
#### **解决方案**
##### 1
. **检查并修正 URL 配置**
在 `application
.properties` 或 `application
.yml` 中：
```properties
# 官方 Open
AI 服务的正确配置
spring.ai.open
ai.base
-url=https://
api.open
ai.com
spring.ai.open
ai.embedding
.options
.api=/v1/embeddings
# 若使用 Azure Open
AI
spring.ai.open
ai.api-type=azure
spring.ai.open
ai.base
-url=https://{YOUR_RESOURCE}
.open
ai.azure
.com
spring.ai.open
ai.embedding
.options
.api=/open
ai/deployments/{DEPLOYMENT}/embeddings?
api-version=2023
-12
-01
-preview
```
##### 2
. **验证路径拼接逻辑**
- Spring AI 会拼接 `base
-url +
api-path`，确保两者**不包含重复部分**。
```
java
// 错误：导致路径重复
base
-url: "https://host/
api-open
ai/v1/embeddings"
api-path: "/
api/v1/services/
..." // 实际 URL 变为 "
api-open
ai/v1/embeddings/
api/v1/
..."
```
##### 3
. **检查依赖版本兼容性**
- 确认 `
spring-ai-bom` 版本（如 `1
.0
.0
-M2`）与 Open
AI/Azure 客户端兼容。
```xml
<!
-- pom
.xml 依赖示例
-->
<dependency>
<groupId>org
.springframework
.ai</groupId>
<artifactId>
spring-ai-open
ai-spring-boot
-starter</artifactId>
<version>${
spring-ai.version}</version>
</dependency>
```
##### 4
. **网络与权限验证**
- 若使用自托管服务，检查网络连通性（参考引用 [^2] 的 `ping` 测试）。
- 确保
API 密钥有效且具有调用权限：
```properties
spring.ai.open
ai.api-key=sk
-xxxxxxxxxxxx
```
---
#### **总结步骤**
1
. **修正配置**：检查 `base
-url` 和 `
api` 路径是否重复。
2
. **统一路径格式**：使用官方标准路径（如 `/v1/embeddings`）。
3
. **验证依赖**：确保
Spring AI 版本与目标服务兼容。
4
. **诊断网络**：测试服务端可达性（参考引用 [^2]）。
> 若问题仍存在，启用 DEBUG 日志定位具体请求 URL：
> ```properties
> logging
.level
.org
.springframework
.web
.client=DEBUG
> ```
超级会员免费看
订阅专栏 解锁全文
扫一扫
173
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
