Next.js Actions中调用Mongoose的方案及JSON转换问题

1. 是否可以在服务端Actions中直接调用Mongoose的find方法？ #

完全可以。Next.js的服务端Actions（标记'use server'的函数）运行在服务端环境，和API路由拥有相同的权限，能够直接连接并操作MongoDB数据库，无需额外中间层。

2. 是否需要将查询放在API路由中再通过HTTP调用？ #

不需要。直接在服务端Actions中调用Mongoose查询是更高效的方案——省去了额外的HTTP请求开销，代码结构也更简洁。只有当你需要对外暴露公共API接口时，才需要单独编写API路由。

3. 服务端Actions中如何将Mongoose查询结果转为JSON？ #

Mongoose的find方法默认返回Mongoose Document对象（带有额外Mongoose方法和属性），要转为JSON兼容的普通JavaScript对象，有两种常用方式：

方式一：使用.lean()（推荐）

在查询时添加.lean()方法，Mongoose会直接返回普通JS对象，无需额外转换，性能更优：

'use server';

import User from '@/models/User';

export async function getUsers() {
  try {
    // 使用lean()直接获取普通JS对象数组
    const users = await User.find().lean();
    // 直接返回即可，Next.js会自动处理序列化
    return users;
  } catch (error) {
    throw new Error('Failed to fetch users');
  }
}

方式二：使用.toJSON()处理Document对象

如果未使用.lean()，可以对每个Document对象调用.toJSON()方法，将其转为普通对象：

'use server';

import User from '@/models/User';

export async function getUsers() {
  try {
    const userDocs = await User.find();
    // 将Document数组转为普通对象数组
    const users = userDocs.map(doc => doc.toJSON());
    return users;
  } catch (error) {
    throw new Error('Failed to fetch users');
  }
}

注意：服务端Actions返回的结果会自动被Next.js序列化，不需要手动调用JSON.stringify()或NextResponse.json()（后者是API路由专用方法）。

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