Neo4j GraphQL Express服务器OGM初始化遇未处理Promise拒绝错误

你遇到的错误是典型的未处理Promise拒绝，错误信息显示拒绝原因是[object Array]但无具体代码位置，以下是针对性的调试和解决方法：

错误信息重现 #

node:internal/process/promises:289
            triggerUncaughtException(err, true /* fromPromise */);
            ^

[UnhandledPromiseRejection: This error originated either by throwing inside of an async function without a catch block, or by rejecting a promise which was not handled with .catch(). The promise rejected with the reason "[object Array]".] {   code: 'ERR_UNHANDLED_REJECTION' }

Node.js v20.3.0

调试步骤 #

1. 启用完整调用栈跟踪 #

启动Node.js时添加--trace-uncaught参数，直接定位错误来源：

node --trace-uncaught app.js

该参数会打印未处理拒绝的完整调用栈，帮你找到触发异常的具体代码行。

2. 统一异步代码风格，避免捕获遗漏 #

你的getChallenges是async函数，但混用了await与.then/.catch，这种写法容易导致错误捕获不完整。建议统一用await替代链式调用，让所有异步错误都能被外层try/catch捕获：

const getChallenges = async (req, res) => {
    try {
      // ... 其他业务逻辑
      const challenges = await Challenge.find({
            // 你的查询条件
        });
      // 处理查询结果
      res.status(200).json(challenges);
    } catch (error) {
        // 打印完整错误信息，包括数组形式的错误详情
        console.error("获取挑战数据失败:", error);
        res.status(500).json({ error: "服务器内部错误" });
    } 
}

3. 排查所有Promise操作的错误处理 #

检查代码中所有返回Promise的操作：

• 除OGM初始化外，确认Neo4j Driver的连接是否有遗漏的错误监听
• 其他模型操作（如Challenge.create、update等）是否都添加了错误捕获
• 避免在async函数中返回未处理的Promise

4. 打印完整错误详情 #

由于拒绝原因是数组，在所有catch块中打印完整错误内容，不要只打印部分信息：

.catch((err) => {
    // 展开数组查看详情
    console.error("错误详情:", ...err);
    // 或转成JSON查看结构
    console.error("错误JSON:", JSON.stringify(err));
});

5. 监听Neo4j Driver的连接错误 #

OGM初始化的try/catch可能无法捕获驱动层面的延迟错误，可添加驱动错误监听：

const driver = neo4j.driver(/* 你的连接配置 */);
// 监听驱动连接错误
driver.on('error', (err) => {
    console.error("Neo4j驱动错误:", err);
});

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