Unity连接Hololens2 Device Portal API超时问题求助

针对你遇到的编辑器运行正常、部署到设备后请求超时的情况，以下是几个实际的排查和解决方向：

1. 补全身份验证逻辑 #

Hololens2 Device Portal API需要身份验证，编辑器环境可能自动复用了你通过浏览器登录的凭据，但UWP应用必须显式添加认证头：

string portalUsername = "你的Device Portal用户名";
string portalPassword = "你的Device Portal密码";
string authToken = Convert.ToBase64String(Encoding.ASCII.GetBytes($"{portalUsername}:{portalPassword}"));
// WebRequest方式
request.Headers.Add("Authorization", $"Basic {authToken}");
// HttpClient方式
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", authToken);

2. 解除本地回环访问限制 #

UWP应用默认会阻止本地回环访问（比如访问127.0.0.1或设备自身局域网IP），即使开启了Private Network权限，也需要额外配置：

• 在Package.appxmanifest中添加rescap命名空间并声明回环权限：

<Package
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="uap mp rescap">
  ...
  <Capabilities>
    <rescap:Capability Name="allowLocalNetworkLoopback" />
    <!-- 保留你已开启的其他权限 -->
  </Capabilities>
</Package>

• 或者通过设备上的PowerShell命令单独解除应用的回环限制：

CheckNetIsolation LoopbackExempt -a -n="你的应用包名"

3. 处理自签名证书信任问题 #

Device Portal使用自签名HTTPS证书，UWP应用默认会拒绝这类未受信任的证书，导致请求被静默拦截（表现为超时）：

• 测试环境临时方案：在代码中跳过证书验证（仅限测试，正式环境禁用）：

ServicePointManager.ServerCertificateValidationCallback += (sender, cert, chain, sslPolicyErrors) => true;

• 正式环境方案：将Device Portal的证书导出，安装到Hololens2的「受信任的根证书颁发机构」存储中。

4. 检查Device Portal的访问设置 #

在Hololens2的Device Portal网页中确认：

• 已开启「允许本地应用访问Device Portal」选项（通常在「安全性」或「API设置」板块）
• 请求URI使用了正确的端口（默认HTTPS端口为443，若修改过需同步调整）

5. 核对权限声明细节 #

确认Package.appxmanifest中的权限声明完整且正确：

<Capabilities>
  <Capability Name="internetClient" />
  <Capability Name="internetClientServer" />
  <Capability Name="privateNetworkClientServer" />
</Capabilities>

其中privateNetworkClientServer是访问本地/局域网资源的核心权限，不可遗漏。

内容的提问来源于stack exchange，提问作者Kamil Małochleb