Jenkins执行ng build缺失assets及angular.json配置文件问题求助

根据你描述的情况——本地和手动在构建服务器执行ng build完全正常，但Jenkins（哪怕以管理员身份从工作区跑脚本）却丢失assets、部分angular.json配置文件，样式也没正确编译，且CLI无报错——这大概率是Jenkins构建环境与手动执行环境的差异导致的，以下是几个关键排查和解决方向：

1. 强制切换到项目根目录执行构建 #

Jenkins默认的工作目录可能不是你的Angular项目根目录（也就是存放angular.json的文件夹），这会导致Angular CLI无法正确识别配置文件和assets路径。

• 解决方案：在你的PowerShell构建脚本开头，先切换到项目根目录，再执行构建命令：

  # 替换为你的项目根目录路径，比如Jenkins工作区里的项目文件夹
  Set-Location -Path "C:\Jenkins\workspace\your-angular-project"
  # 执行构建（根据你的配置添加--configuration参数）
  ng build --configuration production
  

• 验证方法：在Jenkins构建日志里添加Get-Location命令，查看当前工作目录，对比手动执行时的目录是否一致。

2. 清理Angular缓存和旧dist文件 #

Jenkins的构建环境可能残留了之前的CLI缓存，导致构建时没有重新处理assets和配置文件。

• 解决方案：在构建前添加清理步骤：

  # 清理Angular CLI缓存（Angular 12+可用，旧版用ng clean）
  ng cache clean
  # 删除旧的dist文件夹
  Remove-Item -Recurse -Force dist -ErrorAction SilentlyContinue
  # 执行构建
  ng build --configuration production
  

3. 对齐Jenkins与手动环境的Node.js/Angular CLI版本 #

手动执行时的Node.js、Angular CLI版本可能和Jenkins环境不一致，这会导致构建行为差异（比如不同版本的CLI对assets的处理逻辑有变化）。

• 解决方案：
  1. 在Jenkins构建步骤里添加版本检查命令：

     node -v
     ng -v
     

  2. 对比手动执行时的版本输出，确保两者完全一致。
  3. 如果版本不一致：
     • 用Jenkins的NodeJS插件配置对应的Node.js版本；
     • 优先使用项目本地的Angular CLI执行构建（避免全局版本冲突），命令改为：

       .\node_modules\.bin\ng build --configuration production
       

4. 检查angular.json的路径配置与大小写 #

虽然Windows不区分大小写，但Git或Jenkins的环境可能对路径大小写敏感，或者assets配置的相对路径有误。

• 验证方法：
  • 确认angular.json里的assets配置都是正确的相对路径，比如：

    "assets": [
      "src/favicon.ico",
      "src/assets",
      "src/manifest.webmanifest"
    ]
    

  • 检查Jenkins工作区里这些路径对应的文件/文件夹是否存在（避免Git拉取时因为.gitignore或其他原因缺失）。

5. 开启Verbose日志排查细节 #

当前CLI没有报错，但开启verbose日志可能会发现assets处理过程中的隐性问题（比如跳过某些文件的原因）。

• 解决方案：执行构建时添加--verbose参数：

  ng build --configuration production --verbose
  

• 重点查看日志中关于assets processing的部分，是否有类似Skipping asset或Could not resolve asset的提示，这些线索能帮你定位具体问题。

6. 调整PowerShell执行策略 #

虽然你排除了权限问题，但Jenkins执行PowerShell脚本的方式可能和手动不同，比如非交互式环境下的执行策略限制。

• 解决方案：在Jenkins的PowerShell构建步骤里，用以下方式执行脚本：

  powershell -ExecutionPolicy Bypass -File ".\deploy.ps1"
  

  或者在脚本开头添加：

  Set-ExecutionPolicy Bypass -Scope Process -Force
  

先从工作目录对齐和版本一致性这两个最常见的原因入手排查，大概率能解决问题。如果还是不行，verbose日志会给你更精准的线索。

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