美西VPS，官方docker-compose方式部署Lobehub，环境变量中配置了智谱apikey，在“资源”中上传docx文件，向量化失败

快速结论：该报错发生在通过官方 Docker Compose 自部署 LobeChat，使用智谱 (ZhiPu) API 进行文档向量化时出现的 “AgentRuntimeError”。优先排查 LobeChat 版本，回退到 2.2.5 版本可解决此问题。

问题场景

用户在美西 VPS（Debian 12）上，通过官方 Docker Compose 部署 LobeChat 2.2.8 版本，使用 Nginx 反代并配置了 Xray Reality 流量。在环境变量中配置了智谱 API Key (ZHIPU_API_KEY) 和向量化模型 (DEFAULT_FILES_CONFIG=embedding_model=zhipu/embedding-3)。在知识库“资源”中上传 docx 文件时，文件上传成功，但后续向量化步骤失败。

报错原文

AgentRuntimeError

Docker 容器日志中查看相关错误信息：

docker compose logs lobe | grep -A 20 "AgentRuntimeError\|embeddingChunks\|zhipu"

原因分析

此问题为 LobeChat 特定版本（2.2.7 及 2.2.8）的回归缺陷，并非环境配置或 API 连通性问题。用户通过以下方式确认了 API 端点和网络连通性正常：

在容器内使用 wget 直接调用智谱 embedding API 能够正常返回 data 字段。
在宿主机上使用 curl 调用智谱 embedding API 也验证通过。
在 LobeChat 设置页面中可以正常连通 DeepSeek 和 Gemini（非客户端模式）。

此外，该 Issue 被标记为与 #11245、#5452、#7186 重复，进一步佐证此为版本已知 Bug。

环境排查

LobeChat 版本： 2.2.8（问题版本），2.2.7（同样存在问题），2.2.6（未验证），2.2.5（正常版本）
部署方式： 官方 Docker Compose
操作系统： Debian 12（美西 VPS）
模型供应商： 智谱 AI (ZhiPu API) – embedding-3 模型

解决步骤

停止当前 LobeChat 容器：
在 Docker Compose 部署目录下执行：
```
docker compose down
```
修改 Docker Compose 文件中的镜像标签为 2.2.5：
将 image: lobehub/lobe-chat:latest 或 image: lobehub/lobe-chat:2.2.8 修改为：
```
image: lobehub/lobe-chat:2.2.5
```
重新启动容器：
```
docker compose up -d
```