通过USB连接手机调试Xamarin Forms调用Asp Core Web Api时遇超时问题

我之前调试Xamarin应用对接本地API时也踩过类似的坑，给你整理几个实用的排查和解决方向：

• 确认API的监听地址：默认ASP.NET Core调试时可能只绑定localhost，这只有本机能访问，模拟器/真机根本连不上。你需要修改项目的launchSettings.json，把applicationUrl改成http://0.0.0.0:51213;https://0.0.0.0:xxxx（xxx是你的HTTPS端口）；或者在Program.cs里直接指定监听地址：

  app.Run("http://0.0.0.0:51213");
  

  这样API会监听电脑所有网卡的请求，外部设备才能访问到。

• 排查防火墙拦截：Windows防火墙大概率会拦截外部设备对本地端口的请求。你可以先临时关闭防火墙测试，如果能正常访问了，就去防火墙的“高级设置”里添加一条入站规则，允许51213端口的TCP连接，并且勾选“私有网络”权限。

• 区分模拟器和真机的访问IP：

  • 如果你用的是Android官方模拟器，10.0.2.2确实是映射主机localhost的地址，但如果是Genymotion这类第三方模拟器，得换成10.0.3.2；
  • 重点！你是USB连接的真机，这时候不能用10.0.2.2！得用你电脑在局域网里的实际IPv4地址（打开CMD输入ipconfig，找到无线/有线网卡的IPv4，比如192.168.1.105），而且手机必须和电脑处于同一个WiFi网络下，或者开启USB网络共享（让手机通过电脑的网络访问，这时候电脑的共享IP可能是192.168.42.1之类的，具体看系统）。

• 检查CORS配置：虽然Postman能正常访问，但Xamarin作为客户端可能会被CORS策略拦截（不过超时的话这个概率稍低，但还是要确认）。在ASP.NET Core的Program.cs里配置允许跨域：

  builder.Services.AddCors(options =>
  {
      options.AddPolicy("AllowAllRequests", policy =>
      {
          policy.AllowAnyOrigin()
                .AllowAnyMethod()
                .AllowAnyHeader();
      });
  });
  
  // 注意顺序：要放在UseRouting之后，UseAuthorization之前
  app.UseCors("AllowAllRequests");
  

• 测试基础网络连通性：先在手机的浏览器里直接访问API的URL（比如http://你的电脑IP:51213/api/xxx），如果浏览器也打不开，那肯定是网络层面的问题（比如IP不对、端口没开放）；如果浏览器能正常返回数据，再检查你的Refit/HttpClient代码：有没有拼写错URL？有没有设置过太短的超时时间？比如HttpClient默认超时是100秒，但如果代码里改成了1秒，那肯定会超时。

• 排除调试断点阻塞：有时候ASP.NET Core在调试模式下会停在断点上，导致请求一直等待超时。你可以先关掉API的调试模式，直接运行项目，再用Xamarin测试。

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