Azure部署ASP.NET Core应用：新增WebAPI控制器出现500内部错误

我前段时间刚踩过一模一样的坑！你这种情况核心原因就是新增的CSHTML文件夹没被正确打包进发布包，导致Azure服务器上找不到相关文件——旧控制器正常是因为它们依赖的文件早就部署好了，不受这次发布遗漏的影响。

给你几个亲测有效的解决步骤：

• 检查项目文件的资源配置
  直接编辑你的.csproj文件，把CSHTML所在文件夹设置为随发布包输出：

  <ItemGroup>
    <!-- 替换成你的CSHTML文件夹路径 -->
    <Content Update="Views/YourNewFolder/**/*.cshtml">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
  </ItemGroup>
  

  要是用Visual Studio，也可以右键目标文件夹→属性→「复制到输出目录」选择「如果较新则复制」，效果是一样的。

• 调整Azure发布策略
  如果你用的是增量发布，有时候会因为文件是新增的，同步时被遗漏。建议试试Zip部署：本地生成发布Zip包，然后通过Azure门户的「部署中心」上传，或者用Kudu的「Zip Push部署」功能，这种方式能确保所有文件都被完整上传。

• 用Kudu快速验证问题
  登录Azure网站的Kudu控制台（路径：网站→高级工具→Go），进入site\wwwroot目录，看看你的CSHTML文件夹有没有出现在这里。如果没有，手动上传整个文件夹测试一下——要是上传后500错误消失，就实锤是发布遗漏的问题了。

• 清理本地缓存后重新发布
  有时候本地的发布缓存会搞事情，右键项目→「清理解决方案」，接着「重新生成解决方案」，再重新发布，避免旧缓存导致文件没被打包。

额外提个排查小技巧：要是Kudu日志里没显示具体错误，你可以在appsettings.json里开启详细日志：

"Logging": {
  "LogLevel": {
    "Default": "Information",
    "Microsoft.AspNetCore": "Debug"
  }
}

重新发布后，就能在Kudu的日志里看到更详细的异常信息，比如「找不到XXX.cshtml」的具体路径，能更快锁定问题点。

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