如何修复Nrwl/NX构建报错：资源路径必须以项目源根目录开头

这个报错本质是项目配置里硬编码了Windows风格的反斜杠路径，触发了Nx的跨平台路径校验逻辑：
报错信息里显示项目配置的sourceRoot是apps\dmc-svr\src，用的是Windows系统专属的反斜杠\作为路径分隔符，但Linux环境下路径分隔符为正斜杠/。Nx在Linux CI环境做资产路径校验时，无法将硬编码的反斜杠路径和系统解析出的POSIX格式绝对路径/root/dev/apps/dmc-svr/src/assets做前缀匹配，直接抛出校验失败。Windows环境本身原生兼容反斜杠路径解析，所以本地构建不会触发该问题。

• 替换所有硬编码的反斜杠路径
  全局排查项目配置文件，把所有写死的反斜杠路径全部替换为正斜杠/，重点排查以下文件的路径相关字段（包括sourceRoot、assets、outputPath、fileReplacements等）：
  • 根目录nx.json
  • 对应项目下的project.json
  • 若使用Angular/React/Vue等框架的专属构建配置，同步检查angular.json、vite.config.ts、webpack.config.js等配置文件
    配置示例参考：

  错误写法（仅Windows兼容）：

  "sourceRoot": "apps\\dmc-svr\\src",
  "assets": ["apps\\dmc-svr\\src\\assets", "apps\\dmc-svr\\src\\favicon.ico"]
  

  正确写法（全平台兼容）：

  "sourceRoot": "apps/dmc-svr/src",
  "assets": ["apps/dmc-svr/src/assets", "apps/dmc-svr/src/favicon.ico"]
  

• 统一用路径API处理路径拼接
  所有涉及路径拼接的逻辑，不要手动写分隔符拼接字符串，统一使用Node.js内置path模块的API（比如path.join()、path.resolve()），该模块会根据当前运行的操作系统自动选择适配的路径分隔符，从根源避免跨平台路径格式问题。
• 增加前置校验避免问题复现
  可以在项目lint规则或者git pre-commit钩子中增加简单的路径格式校验，禁止在JSON/TS配置文件中提交硬编码的反斜杠相对路径，避免其他使用Windows开发的协作者后续再次写入不兼容的路径配置。
• 本地验证修复效果
  修复完成后，可以本地通过WSL或者Docker启动Linux环境执行一次构建，确认无路径类报错后再推送代码到CI，减少CI环境的调试成本。

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