Next.js 13 SSG导出后页面导航URL自动追加txt后缀问题求助

核心问题分析 #

你遇到的txt后缀自动追加、本地npm run start异常，本质是静态导出配置错误或Cloudflare Pages路由规则冲突，加上静态导出后不能用Next.js默认的start命令启动服务导致的。下面是分步解决方法：

1. 修正Next.js导出配置（next.config.js） #

先确保静态导出的基础配置没有问题：

• 确认output: "export"正确设置，同时开启trailingSlash: true（静态导出必须开启，否则会出现路径解析问题）
• 检查是否有错误的exportPathMap或generateStaticParams逻辑，避免生成带txt后缀的路径
  示例正确配置：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: "export",
  trailingSlash: true, // 关键：静态导出必须开启，确保路由对应index.html
  // 不要添加会修改路径后缀的自定义配置
};

module.exports = nextConfig;

2. 检查路由链接与组件代码 #

• 所有<Link>或原生<a>标签的href必须是纯路径（比如/about），绝对不能写/about.txt
• 排查middleware.ts是否有错误的路由重写逻辑，比如不小心把路径后缀改成了txt
• 检查generateStaticParams返回值，确保没有带txt后缀的参数（比如不要返回{ slug: 'post1.txt' }）

3. 清理本地构建缓存并重新生成静态文件 #

旧的构建缓存可能残留错误文件，执行以下命令彻底清理：

rm -rf .next out node_modules/.cache
npm install
npm run build

构建完成后查看out文件夹：正常路由应该是about/index.html，而不是about.txt。如果仍有txt文件生成，搜索项目中所有引用.txt的代码，找到误写的地方。

4. 修正Cloudflare Pages部署配置 #

• 进入Cloudflare Pages项目后台，设置 > 构建与部署：
  • 构建命令：npm run build
  • 输出目录：out（Next.js静态导出默认输出目录）
• 检查路由规则（设置 > 路由）：删除所有将/*重写到/*.txt的错误规则，确保Cloudflare优先加载index.html文件
• 开启静态站点托管选项，让Cloudflare正确解析静态HTML路由

5. 本地测试静态导出的正确方式 #

Next.js默认的npm run start是启动生产服务器，但静态导出的out文件夹是纯静态文件，不需要Next.js运行时。所以本地测试要用静态服务器：

# 安装serve静态服务器
npm install -g serve
# 启动静态服务
serve out

这样就能模拟Cloudflare Pages的静态环境，验证路由是否正常。

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