解决Cloudflare Pages的308自动重定向问题
内容提要
Cloudflare Pages会将.html网页自动308重定向到无扩展名地址，且无法配置关闭。作者尝试多种方法无效后，通过英文AI获得解决方案：在项目根目录创建functions文件夹，添加_middleware.js文件，用中间件拦截.html请求，内部获取无扩展名HTML并返回200状态，从而保留.html扩展名，避免重定向。
延伸解读
问题根源：Cloudflare Pages的硬编码行为
Cloudflare Pages会将.html请求自动308重定向到无扩展名地址，且该行为无法通过配置关闭。这并非用户配置错误，而是平台底层逻辑。作者尝试多种方法无效，最终通过中间件方案解决，说明该问题具有普遍性，且官方未提供直接开关。
解决方案的核心原理
该方案利用Cloudflare Pages Functions的中间件机制，在请求到达静态资源之前拦截.html请求。通过内部重写URL为无扩展名路径，并调用ASSETS.fetch获取内容，再以200状态返回给浏览器，从而绕过308重定向。此方法保留了原始URL，对SEO友好。
实施要点与注意事项
实施时需在项目根目录创建functions文件夹，并放置_middleware.js文件。代码中通过判断路径是否以.html结尾，然后去除扩展名进行内部请求。注意文件夹位置需与构建输出目录同级，且不要放在其内部。此方法仅适用于.html请求，其他请求正常处理。
Q&A
Cloudflare Pages 为什么会把 .html 页面自动 308 重定向到无扩展名地址？
这是 Cloudflare Pages 底层硬编码的行为，无法通过配置参数关闭。当用户访问带有 .html 后缀的页面时，Cloudflare Pages 会自动将其 308 重定向到去掉 .html 的地址。
如何解决 Cloudflare Pages 的 .html 页面被 308 重定向的问题？
可以通过在项目根目录创建 functions 文件夹，并在其中添加 _middleware.js 文件，使用中间件拦截 .html 请求，内部获取无扩展名的 HTML 并返回 200 状态，从而保留 .html 扩展名，避免重定向。
Cloudflare Pages 中间件解决 308 重定向的具体步骤是什么？
1. 在项目根目录（与输出/构建目录同级，但不要位于其内部）创建 functions 文件夹。2. 在 functions 文件夹中创建 _middleware.js 文件。3. 在 _middleware.js 中添加拦截 .html 请求的代码，代码会移除 .html 扩展名，内部请求无扩展名资源，并将返回的 HTML 响应直接返回给浏览器。
Cloudflare Pages 中间件解决 308 重定向的原理是什么？
当用户请求 .html 页面时，中间件会捕获该请求，在后台向 Cloudflare 请求不带扩展名的页面路径，获取成功的 HTML 响应后，直接将其发送回原始 URL，从而避免重定向跳转，实现旧永久链接立即加载。
为什么使用 .htm 代替 .html 不是好的解决方案？
因为 Cloudflare Pages 不会重写 .htm 文件，但使用 .htm 代替 .html 对于老网站的 SEO 来说显然不行，因为原有的 .html 链接会失效，影响搜索引擎收录和用户体验。
作者在解决 Cloudflare Pages 308 重定向问题时，为什么最终通过英文 AI 获得了有效方案？
作者用中文咨询所有主流 AI 都没有得到好的解决，后来用 Google Translate 将问题翻译成英文，提交给 Google Gemini，Gemini 给出了全新的方案，作者按照该方案尝试后成功解决了问题。这表明英文 AI 在处理此类技术问题时可能更有效。
