解决FastGPT私有部署构建镜像时resolve-url-loader CSS报错问题

现象

下载FastGPT V4.5私有部署代码后，执行docker build -t dockername/fastgpt --build-arg name=app .构建镜像，过程会卡在RUN pnpm --filter=app run build命令，报错信息如下：

Error: resolve-url-loader: CSS error
  PostCSS received undefined instead of CSS string
    at new Input (/app/node_modules/.pnpm/registry.npmmirror.com+postcss@8.4.14/node_modules/postcss/lib/input.js:24:13)
    at encodeError (/app/node_modules/.pnpm/registry.npmmirror.com+next@13.5.2_@babel+core@7.23.2_react-dom@18.2.0_react@18.2.0_sass@1.58.3/node_modules/next/dist/build/webpack/loaders/resolve-url-loader/index.js:85:16)
    at onFailure (/app/node_modules/.pnpm/registry.npmmirror.com+next@13.5.2_@babel+core@7.23.2_react-dom@18.2.0_react@18.2.0_sass@1.58.3/node_modules/next/dist/build/webpack/loaders/resolve-url-loader/index.js:71:18)
    at processTicksAndRejections (node:internal/process/task_queues:95:5)
    at runNextTicks (node:internal/process/task_queues:64:3)
    at process.processImmediate (node:internal/timers:449:9)

可能原因

该报错由resolve-url-loader处理CSS资源时异常导致，具体为PostCSS收到了未定义的非CSS字符串输入，通常与依赖包版本冲突、构建环境配置异常有关，具体需结合实际构建环境确认。

排查步骤

1. 确认当前使用的FastGPT代码版本为V4.5，检查构建过程中是否完整拉取了所有依赖包。
2. 查看完整的构建日志，定位到该CSS报错的具体位置，确认是否与postcss、resolve-url-loader或next相关依赖有关。
3. 检查构建环境的node、pnpm版本，需按FastGPT官方文档指定的环境版本确认。
4. 清理本地pnpm缓存和docker构建缓存，重新执行构建命令。

解决与验证

若问题由依赖版本不匹配导致，可在项目根目录执行pnpm install --force强制重新安装所有依赖，随后重新执行docker构建命令。验证方式为观察构建过程，确认不再卡在RUN pnpm --filter=app run build步骤，且无上述CSS报错信息，最终镜像构建成功。

来源：FastGPT GitHub issue