ASP.Net Web API引入iTextSharp的控制器部署后返回500内部错误

• 确认iTextSharp相关程序集部署完整性
  • 检查服务器站点bin目录下是否存在iTextSharp.dll，如果不存在请在Visual Studio中将该引用的复制本地属性设置为True后重新发布
  • 同步检查iTextSharp依赖的其他附属程序集是否也完成部署，比如字体处理、加密相关的扩展dll
• 检查服务器环境权限与位数适配
  • 确认站点应用程序池身份对iTextSharp.dll有读取权限，对系统临时目录（如C:\Windows\Temp）、站点临时目录有读写权限，iTextSharp生成文件、加载字体时需要临时目录操作权限
  • 如果服务器为64位系统，检查应用程序池是否开启允许32位应用程序选项，32位版本的iTextSharp在64位应用程序池下会加载失败
• 开启详细错误捕获获取具体堆栈
  • 该错误早于Application_Error触发时机，大概率是控制器初始化阶段的程序集加载异常，修改Web.config开启详细错误页：

  在<system.web>节点下添加配置：<customErrors mode="Off" />、<compilation debug="true" />，再次访问报错接口即可看到具体异常信息

  • 也可配置IIS失败请求跟踪功能，捕获500错误的完整触发流程，定位异常根因
• 排查程序集版本冲突
  • 确认服务器GAC（全局程序集缓存）中是否安装了其他版本的iTextSharp，导致加载版本和项目引用版本不一致触发绑定异常
  • 可在Web.config的<runtime>节点下添加程序集绑定重定向规则，强制使用项目引用的iTextSharp版本
• 最小场景验证排除业务代码影响
  • 新增仅引用iTextSharp命名空间的空测试控制器，编写最简单的GET接口部署后访问，如果空控制器也报错即可排除原有业务代码的影响，锁定问题在iTextSharp相关的部署、环境配置层面

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