Next.js + MongoDB API路由文件优化组织方案咨询

完全不需要搭建Express自定义服务器，Next.js自带的API路由就支持在单个文件中处理同一资源的所有CRUD操作，直接整合即可。

1. 单个文件整合CRUD操作 #

根据你使用的Next.js路由模式（App Router / Pages Router），分别提供实现方式：

针对App Router（Next.js 13+） #

在app/api/tasks/route.ts文件中编写以下代码：

import { NextResponse } from 'next/server';
import { connectToDB } from '@/utils/db'; // 你的数据库连接工具
import Task from '@/models/Task'; // 你的Task数据模型

// 新增任务（POST请求）
export async function POST(request: Request) {
  try {
    await connectToDB();
    const taskData = await request.json();
    const newTask = await Task.create(taskData);
    return NextResponse.json(newTask, { status: 201 });
  } catch (err) {
    return NextResponse.json({ error: '创建任务失败' }, { status: 500 });
  }
}

// 更新任务（PUT请求）
export async function PUT(request: Request) {
  try {
    await connectToDB();
    const { id, ...updateFields } = await request.json();
    const updatedTask = await Task.findByIdAndUpdate(id, updateFields, { new: true });
    
    if (!updatedTask) {
      return NextResponse.json({ error: '任务不存在' }, { status: 404 });
    }
    return NextResponse.json(updatedTask);
  } catch (err) {
    return NextResponse.json({ error: '更新任务失败' }, { status: 500 });
  }
}

// 删除任务（DELETE请求）
export async function DELETE(request: Request) {
  try {
    await connectToDB();
    const { id } = await request.json();
    const deletedTask = await Task.findByIdAndDelete(id);
    
    if (!deletedTask) {
      return NextResponse.json({ error: '任务不存在' }, { status: 404 });
    }
    return NextResponse.json({ message: '任务删除成功' });
  } catch (err) {
    return NextResponse.json({ error: '删除任务失败' }, { status: 500 });
  }
}

针对Pages Router #

在api/tasks.ts文件中编写以下代码：

import type { NextApiRequest, NextApiResponse } from 'next';
import { connectToDB } from '../../utils/db';
import Task from '../../models/Task';

export default async function handler(req: NextApiRequest, res: NextApiResponse) {
  await connectToDB();

  switch (req.method) {
    // 新增任务
    case 'POST':
      try {
        const newTask = await Task.create(req.body);
        res.status(201).json(newTask);
      } catch (err) {
        res.status(500).json({ error: '创建任务失败' });
      }
      break;
    
    // 更新任务
    case 'PUT':
      try {
        const { id, ...updateFields } = req.body;
        const updatedTask = await Task.findByIdAndUpdate(id, updateFields, { new: true });
        
        if (!updatedTask) {
          return res.status(404).json({ error: '任务不存在' });
        }
        res.json(updatedTask);
      } catch (err) {
        res.status(500).json({ error: '更新任务失败' });
      }
      break;
    
    // 删除任务
    case 'DELETE':
      try {
        const { id } = req.body;
        const deletedTask = await Task.findByIdAndDelete(id);
        
        if (!deletedTask) {
          return res.status(404).json({ error: '任务不存在' });
        }
        res.json({ message: '任务删除成功' });
      } catch (err) {
        res.status(500).json({ error: '删除任务失败' });
      }
      break;
    
    default:
      res.setHeader('Allow', ['POST', 'PUT', 'DELETE']);
      res.status(405).end(`Method ${req.method} Not Allowed`);
  }
}

2. 进阶结构优化 #

如果你的项目有多个MongoDB集合，建议按资源维度划分API文件：

• 任务相关CRUD → app/api/tasks/route.ts
• 用户相关CRUD → app/api/users/route.ts
  这样既保持了文件简洁，又能清晰区分不同资源的操作逻辑。

3. 关于Express自定义服务器 #

只有当你需要实现复杂的全局中间件、特殊路由规则（如多版本API）或与现有Express项目集成时，才考虑搭建自定义服务器。普通CRUD场景下，Next.js原生API路由完全够用，无需额外引入Express。

内容的提问来源于stack exchange，提问作者José Carlos