ASP.NET Core 2项目间引用发布失败问题求助

嘿，我之前在拆分ASP.NET Core控制器到类库时也碰到过一模一样的问题——开发跑的顺风顺水，一发布就掉链子。结合我的踩坑经验，给你几个针对性的排查和解决步骤：

1. 确认类库项目的基础配置 #

• 先检查子项目的输出类型：右键子项目→属性→应用程序标签页，确保是类库（.NET Framework），绝对不能是Web应用程序。我之前就是不小心改了这个，发布时直接触发Web项目的发布逻辑，导致类库打包失败。
• 同时确认子项目的目标框架是.NET Framework 4.7.1，和主Web项目完全一致，版本不匹配会导致发布时依赖冲突。

2. 确保发布时包含类库输出 #

• 打开主项目的发布配置：右键主项目→属性→发布→点击「配置」按钮，在弹出的窗口里勾选「包含所有项目引用」。如果没勾，发布程序会忽略子项目，导致最终的发布包没有类库的DLL，运行时自然找不到控制器。
• 发布完成后可以手动去发布文件夹的bin目录下看看，子项目的DLL有没有在里面，没有的话就是这个配置的问题。

3. 强制ASP.NET Core发现类库中的控制器 #

ASP.NET Core默认不会自动扫描类库中的控制器，开发环境可能因为调试特性偷偷加载了，但发布时就会失效。你需要在主项目的Startup.cs里手动配置：

• 修改ConfigureServices方法，明确指定要加载的类库程序集：

services.AddMvc()
    // 替换成你子项目中任意一个控制器的类型
    .AddApplicationPart(typeof(SubProjectDemoController).Assembly)
    .AddControllersAsServices();

• 如果子项目有自己的服务注册扩展方法，也可以把这段逻辑放到扩展方法里，让主项目调用扩展时自动加载控制器，这样代码更整洁。

4. 检查NuGet依赖版本一致性 #

• 打开子项目的NuGet包管理器，确保所有和ASP.NET Core相关的包（比如Microsoft.AspNetCore.Mvc、Microsoft.AspNetCore.App等）版本和主项目完全一致。版本不匹配会导致发布时DLL冲突，甚至缺失必要的依赖。
• 举个例子，主项目用Microsoft.AspNetCore.Mvc 2.2.0，子项目就不能用2.1.0，不然发布时肯定会出问题。

5. 清理缓存后重新发布 #

有时候是Visual Studio的缓存搞的鬼，开发时的缓存让项目能正常运行，但发布时旧缓存干扰了打包流程：

• 右键解决方案→清理解决方案
• 然后右键解决方案→重新生成解决方案
• 最后再尝试发布，很多时候这个简单的操作就能解决问题。

6. 查看详细发布日志定位问题 #

如果上面的步骤都没解决，一定要看发布时的详细错误日志：

• 在发布窗口点击「查看日志」，找到具体的错误提示（比如“无法加载程序集XXX”、“控制器未找到”等）。比如如果日志说找不到子项目的DLL，就回到第二步检查发布配置；如果说控制器无法发现，就回到第三步调整程序集扫描逻辑。

内容的提问来源于stack exchange，提问作者Markus S.