NextJS public目录下带点前缀的文件返回404的解决办法求助

方案1：修改next.config.js配置（本地开发/next start部署） #

Next.js默认会忽略public目录下的隐藏文件，可通过配置允许服务这类文件。在项目根目录的next.config.js中添加以下内容：

/** @type {import('next').NextConfig} */
const nextConfig = {
  // 允许访问public目录下的隐藏文件
  staticOptions: {
    dotfiles: 'allow'
  }
};

module.exports = nextConfig;

修改后重启开发服务器或重新部署，即可直接访问目标验证文件。

方案2：用Rewrite规则映射路径 #

如果方案1受部署环境限制无法生效，可通过重写路径绕开隐藏文件限制：

1. 将.well-known-apple-developer-merchantid-domain-association.txt重命名为apple-developer-merchantid-domain-association.txt，保留在public目录下。
2. 在next.config.js中添加Rewrite规则：

/** @type {import('next').NextConfig} */
const nextConfig = {
  async rewrites() {
    return [
      {
        source: '/.well-known-apple-developer-merchantid-domain-association.txt',
        destination: '/apple-developer-merchantid-domain-association.txt'
      }
    ];
  }
};

module.exports = nextConfig;

访问带点的目标路径时，会自动映射到重命名后的文件，不影响Apple Pay验证。

方案3：自定义API路由返回文件内容 #

如果前两种方案都不适用，可通过API路由直接读取并返回文件内容：

1. 在pages/api目录下创建apple-pay-verify.js文件（Pages Router）：

import fs from 'fs';
import path from 'path';

export default function handler(req, res) {
  const filePath = path.join(process.cwd(), 'public', '.well-known-apple-developer-merchantid-domain-association.txt');
  
  try {
    const fileContent = fs.readFileSync(filePath, 'utf8');
    res.setHeader('Content-Type', 'text/plain');
    res.status(200).send(fileContent);
  } catch (error) {
    res.status(404).send('File not found');
  }
}

2. 在next.config.js中添加Rewrite规则，将请求指向该API：

/** @type {import('next').NextConfig} */
const nextConfig = {
  async rewrites() {
    return [
      {
        source: '/.well-known-apple-developer-merchantid-domain-association.txt',
        destination: '/api/apple-pay-verify'
      }
    ];
  }
};

module.exports = nextConfig;

方案4：Vercel部署专属配置 #

若项目部署在Vercel上，可通过vercel.json直接配置路由：
在项目根目录创建vercel.json文件，添加如下内容：

{
  "routes": [
    {
      "src": "/.well-known-apple-developer-merchantid-domain-association.txt",
      "dest": "/.well-known-apple-developer-merchantid-domain-association.txt"
    }
  ]
}

Vercel会根据该配置直接服务对应隐藏文件，无需修改Next.js主配置。

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