部署在NameCheap cPanel的Node+Express+MongoDB应用休眠致404问题求助

核心问题 #

你的代码里/allusers路由是在异步的run()函数内部注册的，而服务器app.listen()是直接启动的——这意味着服务器启动时，MongoDB连接还没完成，/allusers路由还没被添加到Express实例上，所以首次请求会返回404。等run()执行完（MongoDB连接成功），路由才生效，这就是为什么刷新几次能成功的原因。另外，MongoDB连接可能存在不稳定的情况（比如超时、断开），导致后续请求又出现类似问题。

修复步骤 #

1. 调整路由注册时机，确保MongoDB连接完成后再启动服务器
   不要在异步函数里注册路由，而是先完成数据库连接，获取集合实例后，再注册路由并启动服务器。这样能保证服务器启动时所有路由都已就绪。

2. 正确管理MongoDB连接生命周期

   • 不要随意注释client.close()，而是在服务器关闭时才关闭数据库连接，避免连接泄漏。
   • 添加连接错误监听，及时处理连接断开的情况。

3. 给路由添加错误捕获
   数据库查询可能抛出错误，需要在路由里捕获并返回合适的响应，避免请求挂起或者返回无意义的错误。

修改后的代码示例 #

const express = require("express");
const { MongoClient } = require("mongodb");
const cors = require("cors");
require("dotenv").config();

const app = express();
const port = process.env.PORT || 5000;

// Middleware
app.use(cors());
app.use(express.json());

// MongoDB配置
const uri = `mongodb+srv://${process.env.DB_USER}:${process.env.DB_PASS}@xyz`;
const client = new MongoClient(uri);

// 声明集合变量，后续赋值
let allUsersCollection;

async function initDatabase() {
    try {
        await client.connect();
        console.log("MongoDB连接成功");
        const database = client.db("XYZ");
        allUsersCollection = database.collection("All-Users");
        
        // 数据库连接成功后，注册路由并启动服务器
        registerRoutes();
        startServer();
    } catch (err) {
        console.error("MongoDB连接失败:", err);
        process.exit(1); // 连接失败时退出进程，避免无效运行
    }
}

function registerRoutes() {
    // 根路由
    app.get("/", (req, res) => {
        res.send("Server is running just fine");
    });

    // 用户数据路由，添加错误捕获
    app.get("/allusers", async (req, res) => {
        try {
            if (!allUsersCollection) {
                return res.status(503).send("数据库连接未就绪");
            }
            const allData = await allUsersCollection.find({}).toArray();
            res.send(allData);
        } catch (err) {
            console.error("查询用户数据失败:", err);
            res.status(500).send("获取数据失败");
        }
    });
}

function startServer() {
    const server = app.listen(port, () => {
        console.log("Server running on port:", port);
    });

    // 服务器关闭时关闭MongoDB连接
    process.on("SIGINT", async () => {
        await client.close();
        console.log("MongoDB连接已关闭");
        server.close(() => {
            process.exit(0);
        });
    });
}

// 初始化数据库连接
initDatabase();

额外注意事项（针对NameCheap cPanel环境） #

• 确认cPanel的Node.js部署设置里，启动脚本路径正确（比如你的入口文件是server.js，要对应设置）。
• 如果cPanel使用PM2管理进程，查看PM2日志是否有报错，可通过cPanel的Node.js管理器查看。
• 检查MongoDB的IP白名单，确保NameCheap服务器的IP被添加到MongoDB Atlas的白名单中，避免连接被拒绝。

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