[BUG]: AWS ISO Regions for Bedrock

该报错发生在 AnythingLLM 通过 Helm/ENV 配置 AWS 专用区域(如 ISO 区域)后,在 Bedrock 模型选择界面因区域不在下拉列表而出现 UI 崩溃或配置丢失。优先排查是否已升级到包含 #6181 修复的版本,并确认你的 AWS 分区内是否部署了 Bedrock 的 be

快速结论:该报错发生在 AnythingLLM 通过 Helm/ENV 配置 AWS 专用区域(如 ISO 区域)后,在 Bedrock 模型选择界面因区域不在下拉列表而出现 UI 崩溃或配置丢失。优先排查是否已升级到包含 #6181 修复的版本,并确认你的 AWS 分区内是否部署了 Bedrock 的 bedrock-runtime HTTP 服务。

适用环境:AnythingLLM(所有版本均可能触发);AWS Bedrock 模型提供方;使用 Helm 或 ENV 方式配置 AWS 区域的部署环境。Issue 中未确认具体操作系统、Python 或显卡环境。

最快修复方案:升级到包含 PR #6181 修复的版本(该 Issue 于 2026-08-25 关闭)。修复后区域选择器增加“手动输入区域”的兜底方案;通过 ENV/Helm 配置的区域若不在下拉列表中,会渲染为文本输入框,不再导致 UI 崩溃或保存时覆盖原有区域。

注意事项:对于真正的 ISO 区域(us-iso-* 等),官方明确表示无法从外部验证这些分区内的 Bedrock 服务是否可用,需要你在自己的环境中测试确认。如果分区中根本没有部署 bedrock-runtime,客户端无法通过配置修复。

问题场景

用户在 AnythingLLM 中通过 Helm 安装或 ENV 环境变量配置 AWS 的专用区域(Specialized Region,如 ISO 区域)作为 Bedrock 的接入区域。当进入 Bedrock 模型选择界面时出现 UI 崩溃;且界面中没有提供手动添加或修改专用区域的入口。

报错原文

[BUG]: AWS ISO Regions for Bedrock

原因分析

可能原因:AnythingLLM 的 Bedrock 区域配置使用下拉列表形式,仅包含 AWS 公开商业区域。当用户通过 Helm/ENV 写入不在列表中的专用区域时,前端代码无法将已有配置与下拉选项匹配,导致空值渲染异常;在保存操作时可能用空值覆盖掉用户已配置的区域。

环境排查

  • 确认 AnythingLLM 版本是否已包含 #6181 修复(查看版本发布说明或提交记录)。
  • 确认 AWS 区域标识是否正确(如 us-iso-east-1 等 ISO 区域格式)。
  • 确认你的 AWS 分区(Partition)内是否部署了 Bedrock 服务,特别是 bedrock-runtime HTTP 端点。
  • 检查 ENV 或 Helm 中是否已设置自定义端点覆盖变量(见下方解决步骤)。

解决步骤

  1. 将 AnythingLLM 升级到包含 PR #6181 修复的版本。这是官方确认已解决的 UI 崩溃问题。
  2. 升级后,在区域选择器中使用新增的“手动输入区域”功能,直接填写你的专用区域 ID(如 us-iso-east-1)。
  3. 如果区域列表仍然无法直接匹配,可在 ENV 或 Helm 配置中设置以下端点覆盖变量(需替换 <region><your-partition-domain> 为实际值):
AWS_BEDROCK_LLM_RUNTIME_ENDPOINT='https://bedrock-runtime/.<region>.<your-partition-domain>'
AWS_BEDROCK_LLM_MANTLE_ENDPOINT='https://bedrock-mantle/.<region>.<your-partition-domain>'
AWS_BEDROCK_LLM_CONTROL_ENDPOINT='https://bedrock/.<region>.<your-partition-domain>'
  1. 在完成配置后,进入 Bedrock 模型选择页面确认界面正常显示,并验证是否可正常连接模型。
  2. 如果连接失败,请在你的 AWS 分区网络内部检查 bedrock-runtime 服务是否存在(例如通过 curl 探测端点)。官方明确表示:如果 bedrock-runtime 未部署在你的分区中,客户端无法通过任何配置解决。

验证方法

升级后重新通过 Helm/ENV 配置专用区域,进入 Bedrock 模型选择界面,确认界面不再崩溃且能正确显示之前保存的区域配置;尝试连接 Bedrock 模型,确认能正常发起请求并返回响应。若已设置端点覆盖变量,可通过检查日志或直接调用模型来确认请求路径是否正确。

参考来源

Mintplex-Labs/anything-llm #6179

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 20309

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注