现象
本地可启动FastGPT私有部署版本4.8.23的代码，执行命令docker build -f ./projects/app/Dockerfile -t registry.cn-hangzhou.aliyuncs.com/fastgpt/fastgpt:v4.8.1 . --build-arg name=app后，出现报错ERROR: failed to solve: archive/tar: unknown file mode ?rwxr-xr-x。
可能原因
目前无明确官方解释，需结合实际构建环境确认具体触发因素。
排查步骤
- 确认执行的Docker构建命令与示例一致，检查命令参数是否正确。
- 确认本地代码完整，
./projects/app/Dockerfile文件存在且未损坏。 - 查看Docker构建的详细日志，获取更多报错上下文信息。
- 确认Docker服务运行状态正常。
解决与验证
需根据排查结果针对性处理。例如若存在文件权限异常，可调整对应文件的权限配置；若为tar文件处理格式问题，可重新生成构建上下文或更换Docker构建工具版本。验证方式为重新执行目标构建命令，确认报错不再出现。
来源： FastGPT 官方来源
适用性与版本范围
本页适用于官方来源记录的 故障排查 场景。执行变更前，需核对 FastGPT、依赖、API 与部署版本。
安全护栏
凭证与私密数据使用 [REDACTED_CREDENTIAL] 占位符。执行操作前需核对文档的环境与版本。
回滚指引
恢复变更前的技术内容权威快照、已保存配置与数据快照，再执行最小验证场景。