NU1403错误：Lucene.Net.Contrib.3.0.3包哈希验证失败的排查与解决

成因 #

• 本地包文件损坏：哪怕packages文件夹里存在该包，文件可能在下载或存储过程中损坏，导致哈希值和nuget配置记录的不一致
• 全局nuget缓存冲突：这台电脑的全局nuget缓存中存在同版本但哈希值不同的Lucene.Net.Contrib包，构建时优先读取了缓存里的错误包
• 包源不一致：这台电脑使用的nuget包源和其他开发者不同，不同源的同版本包可能存在差异（比如镜像源同步异常、包被篡改）
• 锁定文件不匹配：解决方案的packages.lock.json文件与本地包的哈希值不匹配，可能是其他开发者提交的锁定文件和这台电脑的实际包状态冲突

解决方法 #

• 清理本地包并重新还原：
  1. 删除解决方案根目录packages文件夹中Lucene.Net.Contrib.3.0.3对应的子文件夹
  2. 在终端执行命令 dotnet restore，重新从包源下载正确的包
• 清理全局nuget缓存：
  打开终端执行命令 nuget locals all -clear，清除所有全局缓存的包，之后再执行dotnet restore重新下载
• 统一包源配置：
  检查这台电脑的nuget.config文件（可在解决方案根目录或用户目录下找到），确保和其他开发者使用的包源一致，优先使用官方nuget源
• 重新生成锁定文件：
  删除解决方案中的packages.lock.json文件，执行命令 dotnet restore --use-lock-file 重新生成匹配本地包的锁定文件
• 手动替换包文件：
  从能正常运行的开发者电脑上复制Lucene.Net.Contrib.3.0.3的完整包文件夹，覆盖这台电脑packages文件夹中的对应目录，之后重新构建

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