AWS SAM Accelerate构建应用时依赖解析失败如何解决

问题根因 #

这个报错和你本地装没装jsonpickle没关系，是本地Python版本和目标Lambda运行时的Python版本不匹配导致的。SAM CLI本地解析Python依赖时，会严格按照template里配置的Lambda运行时版本，拉取对应版本兼容的wheel包，你本地安装的jsonpickle是适配当前本机Python环境的，和目标运行时的包兼容规则不匹配，就会报找不到符合要求的包的错误。
你用sam build -u能构建成功，本质是容器模式直接拉取了和Lambda线上运行环境完全一致的镜像安装依赖，不存在版本错配问题。sam sync不是不支持容器模式，只是没开对应配置而已。

可行修复方案 #

• 一劳永逸全局配置：直接执行命令让SAM所有构建操作默认走容器模式，不管是build还是sync都不用额外加参数：

sam config set --global build_use_container true

配置完成后直接执行sam sync --watch就会自动用容器构建依赖，和加-u参数的效果完全一致。

• 单项目配置：如果不想改全局设置，直接编辑项目根目录下的samconfig.toml，在build和sync的参数段里加上容器开关即可：

[default.build.parameters]
use_container = true

[default.sync.parameters]
use_container = true

• 临时绕路方案：先手动执行sam build -u完成首次全量构建，之后跑sam sync --watch --skip-infra-sync做代码热同步即可，不需要每次都走infra同步流程，但首次部署还是建议用前两个方案。

避坑提示 #

不用尝试换jsonpickle版本、重装本地pip依赖这类方案，本质是碰运气凑版本兼容，只要本地Python版本和Lambda运行时版本不一致，后续装其他带C扩展的依赖（比如numpy、pandas这类）还是会碰到同样的解析错误。容器构建是官方推荐的最稳定方案，能1:1复现Lambda线上运行环境，还能避免本地能跑线上报错的问题。
如果开了容器构建还是拉取依赖失败，先检查Docker服务是否正常运行，以及容器网络能不能正常访问PyPI源即可。

内容的提问来源于stack exchange，提问作者David Gard