ASP.NET5项目编译正常但发布到IIS偶发成功且报CS0006错误

触发原因 #

该问题属于Visual Studio 2019 16.8~16.11版本区间的已知发布流程缺陷，与多项目构建调度、发布目标文件的路径解析逻辑相关，具体触发场景如下：

• 发布流程的并行构建逻辑优先级高于常规编译逻辑，会跳过部分依赖项目的增量编译步骤，直接检索输出目录的dll文件，若依赖项目编译还未完成就启动主项目的发布校验，就会随机抛出CS0006错误
• 对应版本的Microsoft.Web.Publishing.targets文件存在路径解析缺陷，当解决方案混合包含.NET 5和.NET Standard 2.0项目时，会错误读取.NET Framework对应的输出路径，而非.NET 5的输出路径，导致找不到对应元数据文件
• 增量发布的本地缓存逻辑异常，会将旧的编译输出路径缓存到发布配置中，后续发布时优先检索旧路径的文件，找不到就直接报错

可落地修复方案 #

方案1：发布配置级调整（优先推荐） #

右键发布使用的.pubxml配置文件，选择「编辑」，在根节点<PropertyGroup>内添加如下两个配置项：

<!-- 强制使用独立MSBuild进程执行发布构建，避免VS内置构建的调度异常 -->
<UseMsbuildExe>true</UseMsbuildExe>
<!-- 禁用发布阶段的并行构建，保证依赖项目按顺序编译完成 -->
<BuildInParallel>false</BuildInParallel>

修改后保存重新发布即可，该配置仅影响当前发布配置，不会改动全局VS设置。

方案2：调整发布行为设置 #

打开发布配置的「设置」页，展开「文件发布选项」：

• 勾选「发布前删除所有现有文件」，避免旧缓存文件的干扰
• 勾选「在发布前预编译」，强制发布阶段重新编译所有依赖项目
  同时右键主项目，选择「项目依赖项」，确认所有关联的类库项目都已被勾选为依赖项，保证构建顺序正确。

方案3：全局构建设置调整（临时验证用） #

如果上述方案无效，可先调整全局构建配置验证问题根源：
打开VS菜单→「工具」→「选项」→「项目和解决方案」→「生成并运行」，将「最大并行项目生成数」修改为1，重启VS后重新发布。如果此时发布正常，即可确认是并行构建调度导致的问题，后续可优先使用方案1的配置级修改，无需一直禁用全局并行构建。

方案4：版本兼容修复 #

如果以上方案都无法解决，可选择以下两种版本调整方案：

• 升级到Visual Studio 2022，该缺陷在2022所有版本中均已修复
• 回滚Visual Studio 2019到16.7.x版本，该版本区间不存在该发布缺陷

内容的提问来源于stack exchange，提问作者Ivan-Mark Debono