Next.js后端能否创建非route.js文件？目录结构规范咨询

问题解析与解决方案 #

你遇到的404问题是因为Next.js App Router（13+版本推荐的路由模式）对API路由的命名和存放规则有强制要求：API路由的入口文件必须命名为route.js（或route.ts），放在app/api/目录下的对应路径文件夹中，其他文件名不会被框架识别为API路由入口，所以ask.js无法被访问，重命名为route.js后才能正常生效。

关于控制器与路由文件的疑问 #

不是每个业务逻辑控制器都必须单独创建文件夹+route.js，但每个独立的API路径必须对应一个包含route.js的文件夹：

• 如果你需要暴露/api/ask这个接口，就必须创建app/api/ask/route.js作为入口
• 你可以把业务逻辑抽离到单独的文件（比如ask.controller.js），然后在route.js里导入并调用这些逻辑，避免把所有代码堆在route.js中
• 同一模块的多个接口可以共享复用的控制器文件，比如用户模块的login、info接口，都可以导入user.controller.js里的通用逻辑

Next.js App Router 后端目录结构规范 #

核心规则

• API路由必须放在app/api/目录下，每个API路径对应一个子文件夹，入口文件固定为route.js
• 支持HTTP方法：在route.js中导出GET、POST、PUT、DELETE等函数，分别对应处理不同请求方法
• 动态路由：需要动态参数（如/api/user/123）时，文件夹命名为[id]，在route.js中通过params.id获取参数

推荐目录结构示例

app/
├── api/
│   ├── ask/
│   │   ├── route.js          # 对应 /api/ask 接口，处理请求入口
│   │   └── ask.controller.js # 抽离的提问相关业务逻辑
│   ├── user/
│   │   ├── [id]/
│   │   │   └── route.js      # 对应 /api/user/[id] 动态路由
│   │   ├── login/
│   │   │   └── route.js      # 对应 /api/user/login 登录接口
│   │   └── user.controller.js# 用户模块复用逻辑（如查询、验证）
│   └── common/               # 全局复用工具
│       ├── auth.js           # 鉴权中间件
│       └── db.js             # 数据库连接配置
└── ... # 前端页面相关目录（如page.js等）

额外注意

• 若使用旧版Pages Router，API路由是放在pages/api/下，文件名直接对应接口路径（比如pages/api/ask.js即可访问/api/ask），但Next.js 13+官方推荐使用App Router
• 全局中间件可放在app/middleware.js中，统一处理所有请求的鉴权、日志等逻辑
• 敏感配置（如数据库密钥）放在.env.local文件中，通过process.env.变量名访问

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