Next.js 使用 output: 'export' 静态导出时，Windows IIS 服务器因缺少正确 MIME 类型映射，会将无扩展名的动态路由（如 /stackoverflow/123）错误解析为 .txt 文件，导致 URL 自动补全 .txt 后缀；根本原因在于 IIS 的静态文件处理机制与 Next.js 静态导出模式不兼容。
next.js 使用 output: 'export' 静态导出时，windows iis 服务器因缺少正确 mime 类型映射，会将无扩展名的动态路由（如 /stackoverflow/123）错误解析为 .txt 文件，导致 url 自动补全 .txt 后缀；根本原因在于 iis 的静态文件处理机制与 next.js 静态导出模式不兼容。
该问题并非 Next.js 路由逻辑缺陷，而是 next export 模式与 Windows IIS 服务器配置冲突的典型表现。当启用 output: 'export' 时，Next.js 会生成纯静态 HTML 文件（如 stackoverflow/[questionId]/index.html），并依赖服务器将所有未匹配物理文件的请求回退至 index.html（即 SPA fallback）。然而，IIS 默认对无扩展名路径（如 /stackoverflow/123）应用了 text/plain 内容类型，并可能触发 .txt 后缀自动补全行为——这在 npm run dev（Node.js 服务）下不会发生，因为开发服务器原生支持动态路径匹配。
✅ 正确解决方案（按优先级排序）
1. 禁用 output: 'export'，改用 Server-Side Rendering（推荐）
output: 'export' 本质是为无服务端环境设计的静态站点方案，不适用于含动态参数的路由（如 /stackoverflow/[questionId]）。应切换回默认的混合渲染模式：
// next.config.js —— 移除 output: 'export'
/** @type {import('next').NextConfig} */
const nextConfig = {
// ❌ 删除这一行：
// output: 'export',
distDir: 'build',
};
module.exports = nextConfig;
构建命令改为：
next build && next start
此时 Next.js 会在 Node.js 环境中运行，完整支持动态路由、SSR 和 ISR，彻底规避 IIS 的静态文件陷阱。
2. 若必须使用静态导出：修正 IIS 配置
在 web.config 中显式声明所有路由返回 index.html，并强制设置 Content-Type 为 text/html：
<?xml version="1.0" encoding="UTF-8"?><configuration><system.webserver><staticcontent><!-- 移除 .txt 的默认映射，避免歧义 --><remove fileextension=".txt"></remove><!-- 为无扩展名路径指定 HTML 类型 --><mimemap fileextension="" mimetype="text/html"></mimemap></staticcontent><rewrite><rules><rule name="Next.js Static Export Fallback" stopprocessing="true"><match url="^(.*)$"></match><conditions logicalgrouping="MatchAll"><add input="{REQUEST_FILENAME}" matchtype="IsFile" negate="true"></add><add input="{REQUEST_FILENAME}" matchtype="IsDirectory" negate="true"></add></conditions><action type="Rewrite" url="/index.html"></action></rule></rules></rewrite></system.webserver></configuration>
⚠️ 注意：IIS 需启用 URL Rewrite Module，且
web.config必须置于部署根目录。
3. 临时规避：客户端重写路径（不推荐）
若无法修改服务器配置，可在路由跳转前手动移除 .txt：
'use client';
import { useRouter } from 'next/navigation';
function handleConditionClick(questionId: string) {
const router = useRouter();
// 强制清理可能的 .txt 后缀
const cleanPath = `/stackoverflow/${questionId}`.replace(/\.txt$/, '');
router.push(cleanPath);
}
但此方案治标不治本，且可能破坏 SEO 和服务端预渲染能力。
? 验证与调试建议
- 在生产环境访问
/stackoverflow/123时，检查浏览器开发者工具的 Network → Response Headers，确认Content-Type: text/html； - 对比
curl -I https://yoursite.com/stackoverflow/123输出，若返回Content-Type: text/plain或重定向至...txt，即证实 IIS MIME 配置问题； - 升级 Next.js 至
v14+（当前最新稳定版）可获得更健壮的静态导出兼容性，但仍无法绕过 IIS 对动态路径的根本限制。
总结
.txt 后缀问题本质是 output: 'export' 与 IIS 的架构冲突，而非代码错误。最佳实践是放弃静态导出，采用 Next.js 原生 SSR 模式——它既支持动态路由、数据预取、增量静态再生（ISR），又无需定制服务器配置。静态导出仅适用于完全静态的营销页面等场景，不应用于含参数的交互式路由。
