Rails项目自定义404页配置回退后，未匹配路由无法正常展示默认404页

实际问题表现 #

• 最初按照社区教程尝试为Rails项目配置自定义404页面，配置完成后功能未正常生效，于是回滚了所有相关改动
• 在项目 /public 目录下重建了框架默认的404静态文件，在该文件基础上完成内容和样式定制
• 当前异常：直接访问 /404 路径时，定制页面可以正常加载；但访问路由表中未登记的路径（如本地开发环境的 localhost:3000/foo）时，无法展示该定制页面，仅显示左上角印有“Not Found”文本的纯白空白页
• 初步定位怀疑该“Not Found”提示来自项目 node_modules/builtin-status-codes/browser.js 文件，该文件内置了包含 "404": "Not Found" 条目的HTTP状态码映射表，逐行核查相关业务代码后，仍未定位到默认错误页配置失效的根本原因

针对性排查步骤 #

• 校验开发环境错误页开关：Rails开发环境默认开启本地调试模式，即 config.consider_all_requests_local = true，该模式下框架会优先渲染带堆栈详情的调试错误页，不会直接加载 /public 目录下的静态错误页。可临时将该配置置为 false 后重启服务，测试未匹配路由是否能正常加载静态404页面
• 排查前端开发代理拦截逻辑：由于异常提示文本来自前端依赖的node_modules目录，说明请求大概率没有到达Rails后端，而是被前端开发服务（如Webpack Dev Server、Vite）的代理规则拦截。如果代理配置未将所有非静态资源的请求转发到Rails后端服务，前端服务会直接返回内置的404状态码和纯文本提示，自然不会加载Rails侧的定制404页面
• 核查路由兜底配置完整性：检查 config/routes.rb 的末尾配置，确认是否存在回滚操作时误删的兜底路由逻辑——Rails默认会将所有未匹配的请求路由到错误处理动作，如果该兜底逻辑缺失，框架会走默认的错误响应流程，不会正确渲染静态错误页
• 验证静态资源访问权限：直接在浏览器访问 localhost:3000/404.html 路径，确认Rails的静态资源服务能正常返回定制的404文件，同时检查文件编码、系统权限，排除静态资源服务拦截导致文件加载失败的可能
• 检查中间件异常处理逻辑：执行 rails middleware 命令查看项目加载的中间件栈，确认是否存在自定义的异常处理中间件，会将404响应的内容直接替换为纯文本“Not Found”，覆盖原本的静态错误页返回逻辑

注意：本地开发环境下不建议长期关闭调试模式，排查完成后需将 config.consider_all_requests_local 配置恢复为默认值

内容的提问来源于stack exchange，提问作者LJ-03