.NET/React应用无法提供无扩展名的.well-known文件访问（Apple Pay验证）

针对React+ASP.NET项目中，/.well-known/apple-developer-merchantid-domain-association无扩展名文件无法被访问的问题，可按以下方案逐一排查解决：

1. 配置ASP.NET Core的静态文件处理 #

如果是ASP.NET Core项目，直接在Program.cs中添加处理规则，比web.config更直接：

• 方案一：允许所有无扩展名静态文件访问

var builder = WebApplication.CreateBuilder(args);
// ... 其他配置代码

var app = builder.Build();

// 启用静态文件，并允许未知类型文件，指定默认MIME类型
app.UseStaticFiles(new StaticFileOptions
{
    ServeUnknownFileTypes = true,
    DefaultContentType = "text/plain"
});

// ... 其他中间件配置（如路由、SPA等）
app.Run();

• 方案二：仅针对Apple Pay验证文件做精确映射（更安全）

var builder = WebApplication.CreateBuilder(args);
var env = builder.Environment;
// ... 其他配置代码

var app = builder.Build();

// 先启用常规静态文件
app.UseStaticFiles();

// 单独处理Apple Pay验证文件
app.MapGet("/.well-known/apple-developer-merchantid-domain-association", async context =>
{
    var filePath = Path.Combine(env.WebRootPath, ".well-known", "apple-developer-merchantid-domain-association");
    if (File.Exists(filePath))
    {
        context.Response.ContentType = "text/plain";
        await context.Response.SendFileAsync(filePath);
    }
    else
    {
        context.Response.StatusCode = StatusCodes.Status404NotFound;
    }
});

// ... 其他中间件配置
app.Run();

2. 修改web.config（适用于IIS/Azure App Service） #

如果项目依赖IIS或部署到Azure App Service，在web.config的<system.webServer>节点下添加以下配置：

<staticContent>
    <!-- 为无扩展名文件添加MIME类型映射 -->
    <mimeMap fileExtension="." mimeType="text/plain" />
</staticContent>
<handlers>
    <!-- 确保验证文件能被静态文件模块处理 -->
    <add name="ApplePayAssociation" 
         path=".well-known/apple-developer-merchantid-domain-association" 
         verb="GET" 
         modules="StaticFileModule" 
         resourceType="File" 
         requireAccess="Read" />
</handlers>

注意：如果web.config中已有<staticContent>节点，直接在内部添加<mimeMap>即可，避免重复节点。

3. 确保React构建时文件被正确复制 #

确认React项目构建后，验证文件存在于输出目录：

• 检查public/.well-known/apple-developer-merchantid-domain-association是否被复制到build/.well-known/目录下
• 如果未自动复制，可修改package.json的build脚本，手动添加复制命令：
  • Windows环境：

  "scripts": {
    "build": "react-scripts build && copy public\\.well-known\\apple-developer-merchantid-domain-association build\\.well-known\\"
  }
  

  • Mac/Linux环境：

  "scripts": {
    "build": "react-scripts build && cp public/.well-known/apple-developer-merchantid-domain-association build/.well-known/"
  }
  

4. Azure部署额外检查 #

如果部署到Azure App Service：

• 确保部署过程中未忽略无扩展名文件（比如在CI/CD管道中，确认文件被包含在部署包内）
• 可在Azure门户的「配置 > 应用程序设置」中，添加MIME类型映射：键为., 值为text/plain

完成配置后，直接访问https://你的域名/.well-known/apple-developer-merchantid-domain-association，确认能返回文件内容即可完成验证。

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