.NET Framework 4.8 Web API：WebDeploy正常手动发布拷贝异常求助

1. 对比发布文件差异 #

• 直接对比WebDeploy和手动发布生成的文件目录，重点查：
  • 缺失文件：比如web.config变换后的最终文件、第三方依赖dll、bin目录下所有文件是否完整（WebDeploy会自动打包依赖，手动发布可能漏选）
  • 文件版本：确认bin里的项目dll、NuGet包dll版本和WebDeploy部署的完全一致
  • 配置差异：检查手动发布的web.config是否替换了环境相关配置（连接字符串、AppSettings等），WebDeploy会自动执行配置变换，手动发布可能需要手动修改

2. 检查本地发布配置 #

• 查看.pubxml发布配置文件：确认是否勾选Include all files from the project directory，有没有排除必要文件的规则
• 核对发布模式：确保是Release模式，Debug模式带调试依赖，服务器环境兼容性差
• 确认预编译设置：WebDeploy默认会预编译站点，手动发布如果没开预编译，拷贝到服务器后IIS要动态编译，容易出权限或编译错误

3. 服务器IIS配置核查 #

• 应用程序池：确认CLR版本是v4.0，托管管道模式为集成，且池身份有发布目录的读取、执行权限
• 目录权限：检查服务器发布目录的NTFS权限，给IIS AppPool\你的应用池名称添加读取和执行权限
• 模块与处理程序：确认IIS启用了ASP.NET 4.8相关模块（比如ManagedPipelineHandler），WebDeploy会自动配置，手动拷贝可能需要手动检查

4. 错误日志分析 #

• 本地IIS错误截图重点看错误代码：
  • 500.19：web.config配置错误，比如节点格式错、权限不足读不了配置
  • 500.21：模块/处理程序映射问题，比如缺ASP.NET处理程序
• 服务器开详细错误：在IIS站点的错误页设置里开启详细错误，或者看事件查看器的Windows日志->应用程序，里面有ASP.NET具体错误信息
• 移除bin目录的.pdb文件：手动发布带pdb的话，服务器可能缺调试权限，删了再测

5. 依赖与环境检查 #

• 确认服务器装了.NET Framework 4.8完整包，WebDeploy可能自动补装组件，手动拷贝不会
• 查NuGet包依赖：有没有需要安装到GAC的包，WebDeploy会部署本地副本，手动拷贝漏了就会出错
• 用fuslogvw.exe（程序集绑定日志查看器）：在服务器上运行这个工具，看有没有程序集加载失败的情况，定位缺失的依赖

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