Azure部署遇ModuleInitializeException：Microsoft.Identity.Web.Certificate依赖缺失

针对你遇到的部署Azure后触发ModuleInitializeException、缺失相关依赖dll的问题，给你几个可行的解决方向：

• 显式添加缺失的依赖包
  有时候NuGet的传递依赖会在发布时被优化剔除，直接在项目文件里手动添加这几个包的引用，确保它们被打包进发布产物：

  <PackageReference Include="Azure.Identity" Version="1.10.4" /> <!-- 与Microsoft.Identity.Web.Certificate 1.25.3兼容的版本 -->
  <PackageReference Include="Azure.Security.KeyVault.Secrets" Version="4.5.0" />
  <PackageReference Include="Microsoft.Identity.Client.Extensions.Msal" Version="4.56.0" />
  

  版本号可以参考NuGet上Microsoft.Identity.Web.Certificate 1.25.3的依赖清单，避免版本冲突。

• 检查发布配置的依赖修剪策略

  • 如果你开启了依赖修剪（<PublishTrimmed>true</PublishTrimmed>），编译器会移除它判定为未被直接使用的dll，这会导致传递依赖丢失。要么把PublishTrimmed设为false，要么添加修剪保留规则：

    <ItemGroup>
      <TrimmerRootAssembly Include="Azure.Identity" />
      <TrimmerRootAssembly Include="Azure.Security.KeyVault.Secrets" />
      <TrimmerRootAssembly Include="Microsoft.Identity.Client.Extensions.Msal" />
    </ItemGroup>
    

  • 确认部署类型：如果是自包含部署，确保目标运行时配置正确；如果是框架依赖部署，Azure App Service的.NET运行时版本要和本地开发环境完全一致。

• 清理并重新生成发布包
  先在本地执行dotnet clean清理项目缓存，再用dotnet publish重新生成发布文件。检查本地发布目录（比如bin/Release/netX/publish）里是否包含那几个缺失的dll——如果本地都没有，问题出在打包环节，和Azure环境无关。

• 检查Azure部署方式的优化设置

  • 如果用Zip部署，确保zip包包含所有发布目录里的文件，不要手动删除任何dll。建议用官方部署工具（比如Azure DevOps、GitHub Actions的部署任务），它们会自动处理依赖打包。
  • 如果用Web Deploy，取消勾选“排除文件以减小部署大小”这类优化选项，避免依赖被误删。

• 验证Azure环境的运行时配置
  确认Azure App Service的.NET版本和本地开发环境匹配（比如本地用.NET 6，Azure也要设置为.NET 6运行时），版本不匹配也可能导致依赖加载失败。

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