MVC 5 Web应用中配置.well-known文件夹的问题咨询

我来帮你一步步搞定这个问题，这类移动应用验证文件的配置确实容易踩坑，咱们从本地创建到Azure部署逐一排查：

1. 本地正确创建.well-known文件夹 #

Windows默认不让直接创建带前缀.的文件夹，你可以用这两种方法解决：

• 命令行方式：打开命令提示符，切换到项目根目录，执行 mkdir .well-known，就能直接创建成功。
• Visual Studio方式：在解决方案资源管理器里右键添加文件夹，命名为 .well-known.（注意末尾多一个点），Windows会自动去掉最后一个点，生成正确的.well-known文件夹。

创建好后，把apple-app-site-association等文件放进去，记得文件不要加后缀名。

2. 配置MVC路由忽略.well-known路径 #

MVC的默认路由会拦截所有请求，导致静态文件无法直接访问。你需要在RouteConfig.cs里添加忽略规则：

public class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
        // 添加这一行，让MVC不处理.well-known下的任何请求
        routes.IgnoreRoute(".well-known/{*pathInfo}");

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

3. 配置Web.config确保静态文件能被正确解析 #

因为apple-app-site-association没有文件后缀，需要在Web.config里添加MIME类型映射，让IIS能正确识别：

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

如果你的Web.config里已经有<staticContent>节点，直接把<mimeMap>加进去就行。

4. Azure部署的正确配置（替代虚拟目录方案） #

之前用Azure门户加虚拟目录可能没解决根本问题，更稳妥的方式是：

• 确保本地项目里的.well-known文件夹已经包含在项目中（右键文件夹→属性→复制到输出目录选择“如果较新则复制”）。
• 部署到Azure后，进入App Service的配置→路径映射，检查是否有冲突的虚拟目录配置，如果之前加的虚拟目录没用可以删掉。
• 另外，确保Azure App Service的静态文件功能是开启的（默认是开启的，但可以在配置→常规设置里确认）。

5. 验证访问是否正常 #

• 本地测试：启动项目后，访问https://localhost:xxxx/.well-known/apple-app-site-association，应该能看到文件的JSON内容，状态码200。
• Azure测试：部署后用浏览器访问目标URL，或者用curl -v https://portal.mydomain.com/.well-known/apple-app-site-association查看响应，确保返回正确的内容和200状态码。如果遇到404，检查路由配置和文件是否正确部署到Azure的wwwroot目录下。

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