现象
执行docker build -t dockername/fastgpt:tag --build-arg name=app .命令进行镜像构建时，在最后一步出现报错[builder 10/10] RUN pnpm --filter=app build，命令无法正常完成。
可能原因
暂无明确预设的具体原因，需结合实际构建环境确认，可能涉及依赖拉取、版本兼容或配置参数等维度的问题。
排查步骤
- 完整查看docker build执行过程中的全部日志，定位报错的具体细节。
- 核对构建命令参数，确认
docker build -t dockername/fastgpt:tag --build-arg name=app .的配置无误。 - 验证构建主机的网络连接状态，确保可正常拉取所需依赖包。
- 确认构建环境中的pnpm版本是否符合项目要求，需按实际环境确认。
解决与验证
根据排查到的具体问题进行针对性修复，例如调整依赖包拉取源、修正配置参数或更换匹配的pnpm版本。修复完成后，重新执行docker build -t dockername/fastgpt:tag --build-arg name=app .命令，验证最后一步RUN pnpm --filter=app build是否执行成功。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。