Azure DevOps跨项目迁移工作项遇AttachmentNotFoundException，图片失效

问题原因 #

工作项迁移时，图片附件未被同步复制到目标项目B的存储系统，或附件关联路径未更新；也可能是目标项目的权限配置限制了附件读取。

修复步骤 #

1. 验证迁移工具的附件迁移配置 #

若使用Azure DevOps Migration Tools等第三方迁移工具，检查配置文件是否启用附件迁移模块：

{
  "Enabled": true,
  "ObjectType": "WorkItemAttachmentMigrationConfig",
  "MigrateAttachments": true,
  "AttachmentWorkingPath": "c:\\temp\\attachment-cache"
}

确保MigrateAttachments设为true，重新执行迁移任务补传附件。

2. 手动补传附件（快速修复） #

• 从项目A的原工作项下载所有图片附件；
• 打开项目B的目标工作项，重新上传图片，并替换描述、评论中失效的图片链接。

3. 调整权限设置 #

• 进入项目B的安全设置→工作项跟踪权限，确保目标用户/组拥有查看附件的权限；
• 若附件存储在共享位置，确认项目B的服务账户或用户组拥有读取项目A附件存储目录的权限。

4. 用witadmin工具修复附件链接 #

若附件已存在于目标存储但路径错误，执行以下命令更新链接：

witadmin changelink /collection:http://your-tfs-server:8080/tfs/YourCollection /workitemid:【目标工作项ID】 /linktype:Attachment /olduri:【原附件路径】 /newuri:【目标项目附件路径】

预防建议 #

• 迁移前确认工具支持附件迁移，优先使用官方推荐的迁移方案；
• 迁移后批量校验工作项的附件状态，及时发现遗漏问题。

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