为Xamarin.Forms iOS应用配置通用链接：Azure虚拟目录访问文件失败

我来帮你搞定这个通用链接的配置坑，这种情况我之前在配置Xamarin iOS通用链接时也碰到过，咱们一步步排查解决：

1. 先核对Azure虚拟目录的配置细节 #

首先去Azure门户找到你的Web App，进入「配置」>「虚拟应用程序和目录」：

• 确保虚拟目录的路径是.well-known（注意开头的点不能丢）
• 物理路径要准确指向你存放apple-app-site-association文件的实际位置，比如文件在wwwroot/.well-known文件夹里，物理路径就填site\wwwroot\.well-known（用反斜杠，别用正斜杠）
• 重点：别勾选「应用程序」选项，这个只是静态文件目录，勾选后反而会导致IIS把它当成Web应用处理，引发错误

2. 检查apple-app-site-association文件本身 #

这是最容易踩坑的地方：

• 文件名必须是纯apple-app-site-association，不能带任何扩展名（比如.json）！很多人会不小心保存成apple-app-site-association.json，这会直接导致访问失败
• 文件内容要严格符合苹果的规范，示例结构如下：

  {
    "applinks": {
      "apps": [],
      "details": [
        {
          "appID": "你的TeamID.你的BundleID",
          "paths": ["*"] // 根据你的需求调整路径规则
        }
      ]
    }
  }
  

• 配置正确的MIME类型：苹果要求这个文件的Content-Type是application/json，你可以在Web.config里添加这段配置：

  <configuration>
    <system.webServer>
      <staticContent>
        <mimeMap fileExtension="." mimeType="application/json" />
      </staticContent>
    </system.webServer>
  </configuration>
  

  或者在Azure门户的「配置」>「MIME类型」里新增一条：文件扩展名填apple-app-site-association，MIME类型填application/json

3. 用Kudu控制台验证文件状态 #

打开你的Web App的Kudu控制台（通过Azure门户的「高级工具」进入）：

• 导航到你设置的物理路径，确认apple-app-site-association文件确实存在
• 在控制台里执行curl https://portal.mydomain.com/.well-known/apple-app-site-association，看看返回的内容或者错误信息，比浏览器提示更精准

4. 阻止MVC路由拦截请求 #

MVC5默认的路由规则可能会把.well-known识别成控制器名称，导致请求被路由模块拦截。你需要在RouteConfig.cs里添加忽略路由的规则：

public static void RegisterRoutes(RouteCollection routes)
{
    routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
    // 新增这条规则，忽略.well-known路径下的所有请求
    routes.IgnoreRoute("{*wellknown}", new { wellknown = @".well-known(/.*)?" });

    routes.MapRoute(
        name: "Default",
        url: "{controller}/{action}/{id}",
        defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
    );
}

5. 最后验证配置有效性 #

完成以上步骤后，用苹果的App Search API Validation Tool测试你的链接，这个工具会详细告诉你配置中存在的问题，比自己瞎试靠谱多了

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