Mongoose静态方法创建Token时await报错及路由处理问题

报错根本原因 #

你触发的SyntaxError: await is only valid in async functions and the top level bodies of modules语法错误，核心规则非常明确：await关键字仅允许在被async标记的异步函数、或者ES模块的顶层作用域中使用。你定义的generateToken是普通函数，内部直接写await自然不符合语法要求。

为什么去掉await后代码看似能正常运行 #

Mongoose的save()方法确实返回Promise对象，去掉await后的“正常运行”完全是假象：

• 调用new Token(...)的时候，Token实例就已经在Node.js内存中创建完成了，不需要等数据库操作
• 去掉await后，代码不会等待数据库写入动作执行完成，会直接把内存里的Token实例返回
• 只要数据库写入速度够快、且你后续没有立刻校验数据库中的Token记录，就会产生“功能正常”的错觉
• 一旦出现数据库连接闪断、唯一键冲突、写入超时等异常，你既捕获不到错误，数据库里也不会真的存入这条Token记录，后续做Token校验时会随机出现失败，属于极难排查的隐蔽逻辑bug。

符合Node.js编程范式的实现方案 #

你把Token生成逻辑封装到Mongoose静态方法的思路完全符合开发规范，只需要统一使用async/await异步写法、避免回调和Promise混写即可，改完的代码逻辑线性可读，完全没有回调嵌套的复杂度问题。

1. 修正Token静态方法 #

给方法加上async标记，让内部await可以合法生效，确保写入完成后再返回结果：

const crypto = require('crypto'); // 记得提前引入crypto模块

TokenSchema.statics.generateToken = async function(user) {
    const newToken = new this({
        _userId: user._id,
        token: crypto.randomBytes(16).toString('hex')
    });
    await newToken.save(); // 等待数据库写入完成再往下执行
    return newToken;
}

2. 重构路由逻辑，废弃回调写法 #

把路由处理函数改成async函数，所有异步操作统一用await等待执行结果，用try/catch统一捕获异常：

router.get('/profile', requiresLogin, async (req, res, next) => {
    try {
        // 查询用户信息，exec()返回Promise可以直接await
        const user = await User.findById(req.session.userId).exec();
        if (!user) {
            return res.send("Error");
        }
        // 调用async方法必须加await，等待Token生成、入库完成再往下走
        const token = await Token.generateToken(user);
        console.log("Token is: " + token.token);
        return res.send("Working");
    } catch (err) {
        // 所有异步操作的异常都会走到这里，统一处理
        console.error('Profile请求处理失败:', err);
        return res.send("Error");
    }
})

异步写法注意事项 #

• 只要函数内部用到了await，函数本身必须加async标记；调用async函数时如果需要拿到实际返回值、或者等待操作完成，也必须加await
• 用async/await写逻辑时必须配合try/catch做错误捕获，否则异步操作抛出的未捕获异常会直接导致Node进程退出
• 同一业务逻辑里尽量不要混用回调、Promise、async/await三种异步写法，混写很容易出现错误漏捕获、逻辑时序错误的问题

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