Windows 11本地测试应用托管媒体Bot遇NativeMedia DLL加载失败求助

一、解决"Unable to load DLL 'NativeMedia'"异常 #

1. 验证DLL存在与平台匹配 #

• 检查项目输出目录（如bin/x64/Debug/net8.0）是否存在NativeMedia.dll，该文件由Microsoft.Graph.Communications.Calls.Media NuGet包提供，若缺失则重新安装该包并清理重建项目。
• 强制以x64架构运行项目：在Visual Studio的调试→项目属性→生成中，确保平台目标设为x64，取消勾选"首选32位"，避免AnyCPU模式下加载不兼容的32位依赖。

2. 安装VC++运行时依赖 #

• NativeMedia.dll依赖x64版本的Visual C++ Redistributable Runtime（2019及以上版本），下载对应x64架构安装包完成安装。

3. 证书权限与类型检查 #

• 确认证书私钥可访问：右键证书（本地计算机→个人→证书）→所有任务→管理私钥，为当前运行程序的账户（如当前用户、IIS Express账户）添加读取权限。
• 尝试替换为CNG类型自签名证书：CSP证书可能存在兼容性问题，用PowerShell生成CNG证书：

  New-SelfSignedCertificate -CertStoreLocation Cert:\LocalMachine\My -DnsName "你的ServiceFqdn域名" -KeyAlgorithm RSA -KeyLength 2048 -KeyStorageProvider "Microsoft Software Key Storage Provider"
  

  将生成的证书导入受信任根证书颁发机构，更新代码中的CertificateThumbprint为新证书的指纹。

二、本地测试的网络与配置调整 #

1. 端口转发与公网可达性 #

• 使用Ngrok实现本地端口的公网转发：
  • HTTP/Webhook端口：ngrok http 你的本地Web端口 -host-header="localhost:你的本地Web端口"
  • 媒体流端口（TCP/UDP）：ngrok tcp 你的媒体公网端口
• 更新MediaPlatformInstanceSettings参数：
  • ServiceFqdn设为Ngrok提供的公网域名（如xx.ngrok.io）
  • InstancePublicPort设为Ngrok转发的媒体端口
  • InstancePublicIPAddress可保留IPAddress.Any（多数场景下兼容）

2. 防火墙配置 #

• 在Windows防火墙中添加入站规则，允许媒体端口（InstanceInternalPort和InstancePublicPort）的TCP、UDP流量通过，确保外部媒体流能进入本地。

3. 代码配置验证 #

• 核对MediaPlatformSettings参数：确保ApplicationId与Azure AD注册的Bot应用ID一致，CertificateThumbprint与证书指纹完全匹配（注意大小写和无空格）。
• 确保builder.SetMediaPlatformSettings()在Bot初始化的正确阶段调用，无前置配置遗漏。

三、本地测试验证流程 #

1. 启动Ngrok并记录公网域名和端口。
2. 更新项目配置文件中的ServiceFqdn、端口参数和证书指纹。
3. 以x64架构启动Bot项目。
4. 通过Teams或其他通信客户端发起针对Bot的通话邀请，验证媒体会话是否能正常建立，无DLL加载异常。

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