Jenkins PowerShell脚本覆盖文件后Git未检测到变更问题

问题场景 #

Jenkins任务流程：拉取代码仓库→编译C项目→暂存、提交并推送生成的二进制文件。但暂存/提交环节失败，提示Git未检测到任何变更，无内容可提交。

具体操作：编译后通过PowerShell脚本将二进制文件复制到仓库内已被Git跟踪的目录：

• 源文件：.\device_test\images\Device_ROYAL_Firmware_Development.0.img
• 目标文件（已被跟踪）：.\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin

现象：

• 目标文件LastWriteTime已从10/17/2022 12:35 PM更新为10/17/2022 12:41 PM
• Jenkins执行时，git status始终不显示该文件变更，git add -f binaryfile无效果
• 手动命令行执行相同复制操作后，git status能正常检测到变更
• 已尝试git update-index --refresh，问题依旧

解决方案 #

1. 检查Jenkins工作目录的文件权限 #

Jenkins运行的服务账户可能对目标文件/目录没有写入权限，导致文件实际未被覆盖：

• 先检查目标文件权限：

  Get-Acl .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin | Format-List
  

• 如果权限不足，给Jenkins运行账户添加写入权限：

  $acl = Get-Acl .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin
  $rule = New-Object System.Security.AccessControl.FileSystemAccessRule("NT AUTHORITY\SYSTEM","Write","Allow")
  $acl.AddAccessRule($rule)
  Set-Acl .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin $acl
  

2. 强制Git重新检测文件内容 #

Git默认依赖文件时间戳和大小判断变更，若二进制内容变但大小不变，或时间戳更新未被识别，试试强制重新计算哈希：

• 执行更彻底的索引刷新：

  git update-index --really-refresh
  

• 或强制添加文件到索引：

  git add -f --force .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin
  

3. 调整Jenkins Git插件的 checkout 配置 #

Jenkins Git插件的浅克隆、缓存机制可能导致索引异常：

• 关闭任务Git配置中的浅克隆选项
• 勾选Clean before checkout，确保每次构建都是干净的工作目录
• 或构建前手动重置索引：

  git reset --hard HEAD
  git clean -fd
  

4. 验证文件是否真的被正确复制 #

PowerShell复制命令可能因路径、文件锁定等问题未完成覆盖，添加验证步骤：

• 对比源文件和目标文件的哈希值，确认内容一致：

  $sourceHash = (Get-FileHash .\device_test\images\Device_ROYAL_Firmware_Development.0.img -Algorithm SHA256).Hash
  $targetHash = (Get-FileHash .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin -Algorithm SHA256).Hash
  if ($sourceHash -ne $targetHash) {
      Write-Error "文件复制失败，哈希值不匹配"
      exit 1
  }
  

• 复制时添加-Force参数强制覆盖：

  Copy-Item -Path .\device_test\images\Device_ROYAL_Firmware_Development.0.img -Destination .\device_platforms\nordic15_2\device_device\device_out\ROYAL_FW_40.04.10.0.bin -Force
  

5. 检查Git的二进制文件配置 #

确保Git不会对二进制文件做自动转换，避免检测异常：

• 在仓库根目录的.gitattributes文件中添加：

  *.bin binary
  *.img binary
  

• 禁用Windows环境下的文件权限检测：

  git config core.filemode false
  

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