【Bug已解决】Could not resolve the foundation model from the provided model identifier 解决方案
一、现象长什么样
你在 Bedrock 上调模型，收到：
Could not resolve the foundation model from the provided model identifier；- 或
ValidationException: The provided model identifier ... could not be resolved； - 你确信模型 ID 是从文档复制的，但还是解不开；
- 有时是小的拼写差异（如
claude-3-5vsclaude-3-5-sonnet，少了后缀）； - 有时模型 ID 完全对，但该区域不支持这个模型，或你没申请访问；
- 用
bedrock.list_foundation_models()查不到你用的 ID； - 在别的项目/区域能调，换个区域就报这个。
一句话：你传给 Bedrock 的 model identifier 无法被解析成某个可用的基础模型——原因要么是 ID 拼错/格式不对，要么是该区域没有这个模型（或未开放访问），要么你的账户还没获批使用该模型。
二、背景
Bedrock 的"基础模型"是通过一个模型标识符（model identifier）寻址的。这个 ID 必须精确匹配 Bedrock 后台注册的名字，且受两个维度约束：
- 区域可用性：每个模型只在特定区域开放（如某些 Claude 模型只在
us-west-2、us-east-5等）； - 访问授权：很多模型（包括 Claude 系列）需要先"请求模型访问"，审批通过后你的账户才能用。
所以"ID 看起来对"不够——它还必须在你所在的区域存在、且你的账户已获批。Could not resolve是 Bedrock 在模型目录里按 ID 查找失败的统一报错，涵盖上述所有情况。
三、根因
根因是模型 ID 在"当前区域 + 当前账户授权"下找不到：
调用 modelId=X -> Bedrock 在 (region, account) 的模型目录里查 X -> 没找到（ID 错 / 区域不支持 / 未授权） -> Could not resolve the foundation model修复方向：先列出该区域你账户确实可用的模型 ID，用其中的精确值；确认区域支持、访问已批。
四、最小可运行复现
下面用 boto3 演示"先列出可用模型，再使用精确 ID"：
import boto3 client = boto3.client("bedrock", region_name="us-west-2") # 注意用 bedrock（管理面）而非 bedrock-runtime # 1) 列出该区域可用模型（已获批的） resp = client.list_foundation_models( byInferenceType="ON_DEMAND", ) ids = [m["modelId"] for m in resp["modelSummaries"]] print([i for i in ids if "claude" in i]) # 找到精确的 claude ID # 2) 用精确 ID 调用（bedrock-runtime） runtime = boto3.client("bedrock-runtime", region_name="us-west-2") runtime.invoke_model( modelId="anthropic.claude-3-5-sonnet-20241022-v2:0", contentType="application/json", accept="application/json", body=b'{"anthropic_version":"bedrock-2023-05-31","max_tokens":100,"messages":[{"role":"user","content":"hi"}]}', )如果你用的 ID 不在list_foundation_models返回的ids里，就会Could not resolve。
五、解决方案（第一层：最小直接修复）
最小修复是用list_foundation_models核准精确 ID、确认区域与授权：
- 调用
list_foundation_models（管理面bedrock，不是 runtime），筛选claude； - 复制返回里完全匹配的
modelId（含版本后缀、冒号版本号）； - 确认你调用的
region与列出模型时用的region一致； - 若列表里没有该模型：到 Bedrock 控制台"模型访问"页确认已请求并获批；
- 若区域不支持，换到支持的区域。
# 常见正确 ID（以控制台返回为准） MODEL_ID = "anthropic.claude-3-5-sonnet-20241022-v2:0"六、解决方案（第二层：结构化改进）
把"模型 ID 解析"做成策略，调用前先校验该 ID 在 (region, account) 下可用：
from dataclasses import dataclass from typing import List, Set @dataclass(frozen=True) class BedrockModelResolvePolicy: """Bedrock 模型解析策略：调用前校验 ID 在当前区域/账户可用。 规则： - 从 list_foundation_models 获取可用 ID 集合 - 调用前断言目标 ID 在其中 - 提供 '建议替换'（相近 ID）便于纠错 """ available: Set[str] = None def load_available(self, region: str) -> List[str]: import boto3 c = boto3.client("bedrock", region_name=region) resp = c.list_foundation_models(byInferenceType="ON_DEMAND") ids = [m["modelId"] for m in resp["modelSummaries"]] object.__setattr__(self, "available", set(ids)) return ids def resolve(self, model_id: str) -> str: if self.available is None: raise RuntimeError("请先 load_available(region)") if model_id in self.available: return model_id suggestion = [i for i in self.available if "claude" in i][:3] raise ValueError( f"无法解析模型 ID: {model_id!r}。可用 claude 模型示例: {suggestion}" ) def demo() -> None: policy = BedrockModelResolvePolicy() policy.load_available("us-west-2") print(policy.resolve("anthropic.claude-3-5-sonnet-20241022-v2:0")) if __name__ == "__main__": demo()七、解决方案（第三层：断言 / CI 守护）
import pytest from your_module import BedrockModelResolvePolicy def test_resolve_ok(): policy = BedrockModelResolvePolicy(available={"anthropic.claude-3-5-sonnet-20241022-v2:0"}) assert policy.resolve("anthropic.claude-3-5-sonnet-20241022-v2:0") == \ "anthropic.claude-3-5-sonnet-20241022-v2:0" def test_resolve_unknown_raises(): policy = BedrockModelResolvePolicy(available={"a.b:0"}) with pytest.raises(ValueError): policy.resolve("typo.model:0") def test_resolve_suggests_claude(): policy = BedrockModelResolvePolicy(available={"anthropic.claude-x:0", "other:0"}) try: policy.resolve("wrong") except ValueError as e: assert "claude" in str(e) def test_available_is_set(): policy = BedrockModelResolvePolicy(available={"a", "b"}) assert isinstance(policy.available, set) def test_resolve_requires_load(): policy = BedrockModelResolvePolicy() with pytest.raises(RuntimeError): policy.resolve("x")CI 里加一条：在目标区域跑load_available，断言你要用的模型 ID 在其中，避免上线才发现Could not resolve。
八、排查清单
- 是否用
list_foundation_models核对过精确 ID？ID 拼错最常见。 - 调用区域与列模型区域是否一致？区域不支持会解不开。
- 模型访问是否已"请求并获批"？未批的模型解不开。
- 是否混淆了
bedrock（管理面）与bedrock-runtime（推理面）？ - 是否复制了文档示例 ID 但你的账户/区域没有该版本？
- 是否考虑换支持该模型的区域？
九、小结
Bedrock 报Could not resolve the foundation model from the provided model identifier，根因是你传的 model ID 在当前区域、当前账户授权下找不到——要么 ID 拼错、要么区域不支持、要么未获批访问。最小修复是用list_foundation_models核准精确 ID 并确认区域与授权；结构化做法是抽成BedrockModelResolvePolicy，在调用前校验 ID 可用并给出相近建议；最后用 pytest 守护"目标 ID 在可用集合内"，避免上线才撞Could not resolve。
