故障排查GitHub issue2 分钟阅读排错/错误码

解决FastGPT不同运行环境下npm run build编译结果不一致问题

用户在Windows11环境,使用截至20240424的最新开源版FastGPT项目,执行npm run build命令可正常完成编译打包,但在CentOS Linux release 8.1.1911服务器环境执行相同命令时,出现编译错误,附带了对应环境的运行截图与报错截图。

现象

用户在Windows11环境,使用截至20240424的最新开源版FastGPT项目,执行npm run build命令可正常完成编译打包,但在CentOS Linux release 8.1.1911服务器环境执行相同命令时,出现编译错误,附带了对应环境的运行截图与报错截图。

可能原因

由于issue未提供具体报错文本,常见可能包括不同操作系统的依赖包兼容性问题、系统级依赖缺失,或构建流程在类Unix环境下存在适配问题。需结合实际报错日志进一步确认。

排查步骤

  1. 核对服务器与本地的Node.js、npm、pnpm版本,确保与本地环境一致(本地环境版本为node v18.20.2、npm 10.5.0、pnpm 9.0.5)。
  2. 清理服务器上的项目依赖缓存与已安装依赖,执行rm -rf node_modules .pnpm-store命令后,重新执行pnpm install命令。
  3. 查看编译过程中的完整报错日志,定位具体错误类型与触发点。
  4. 检查服务器系统是否缺少本地环境已有的系统级依赖包。

解决与验证

首先按照排查步骤逐一确认环境配置,清理依赖后重新安装并执行构建命令。若为依赖兼容性问题,可尝试锁定依赖版本以匹配跨系统运行需求;若为系统级依赖缺失,需根据报错提示安装对应依赖包。完成调整后重新执行npm run build,验证编译过程无报错且打包产物正常可用。

来源:FastGPT GitHub issue