在Next.js的pages目录添加非页面文件存在哪些问题？

直接引发的功能问题 #

• 生成无效路由：Next.js会自动把pages目录下的文件（除了_app.js、_document.js这类特殊文件，以及下划线开头的文件）转成路由。比如你放个useCustomHook.js，就会多出/useCustomHook这个没用的路由，访问的话如果文件没导出组件，直接报错；导出了组件就会乱渲染。
• 测试文件被打包进生产环境：.test.js或.spec.js这类测试文件放这儿的话，默认会被Next.js打包到客户端包里，既增大体积，还可能把测试代码暴露出去。
• hooks被误当页面处理：自定义hooks一般不会默认导出组件，访问对应的路由时，Next.js会直接抛出No default export found in page的错误，打断正常访问流程。

安全方面的隐患 #

• 敏感信息泄露：如果你的hooks或测试文件里藏了API密钥、内部业务逻辑细节，这些文件被转成路由后，用户直接访问URL就能拿到文件内容，等于把敏感信息公开了。
• 注入攻击风险：要是非页面文件里有没处理好的动态内容，被当作页面渲染时，理论上可能触发XSS这类注入攻击，虽然概率不高，但风险确实存在。

其他隐性麻烦 #

• 开发体验变差：IDE会提示一堆无效路由，找正经路由的时候容易混乱；而且热更新会因为这些非页面文件的变动频繁触发，影响开发效率。
• 构建出问题：非页面文件的命名、导出格式如果和Next.js的页面规则冲突，会导致构建失败，或者生成异常的静态资源，排查起来很麻烦。

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