应用入口需返回Promise吗？Express两种写法的差异与风险探讨

嘿，这个问题问得相当关键！很多人刚开始用Express写服务的时候都会忽略这个细节，咱们来好好掰扯掰扯两种写法的差异，以及第二种写法可能踩的坑。

先明确一下两种典型的写法（毕竟你没贴代码，我就用最常见的场景举例）：

写法1：返回Promise的启动方式 #

async function startServer() {
  // 比如异步初始化数据库、加载配置这类操作
  await connectToDatabase();
  
  const app = express();
  // 配置中间件、路由...
  app.get('/', (req, res) => res.send('Hello World!'));

  // 返回app.listen()的结果（它是一个Thenable的http.Server实例）
  return app.listen(3000);
}

// 统一处理启动成功/失败
startServer()
  .then(() => console.log('✅ 服务器在3000端口启动成功'))
  .catch(err => {
    console.error('❌ 服务器启动失败:', err);
    process.exit(1); // 优雅退出进程，避免僵尸进程
  });

写法2：不返回Promise，直接启动 #

async function startServer() {
  await connectToDatabase();
  
  const app = express();
  // 同样的配置...
  app.get('/', (req, res) => res.send('Hello World!'));

  // 直接调用listen，用回调处理成功
  app.listen(3000, () => {
    console.log('✅ 服务器在3000端口启动成功');
  });
}

// 直接调用，没有后续处理
startServer();

两种写法的核心差异 #

1. 错误处理的完整性

• 写法1：因为app.listen()返回的http.Server是Thenable对象（支持Promise语法），加上我们用async/await包裹了初始化流程，整个启动环节的所有错误（包括数据库连接失败、端口被占用、中间件配置错误等等）都能被.catch()统一捕获，然后我们可以做优雅的错误处理（比如打印日志、退出进程）。
• 写法2：这里有两个坑：
  • 如果connectToDatabase()这类异步初始化操作失败，因为没有try/catch或者.catch()，会触发未处理的Promise拒绝（Unhandled Promise Rejection），在Node.js 16及以上版本，这会直接导致进程崩溃，而且你可能看不到明确的错误日志。
  • app.listen()本身的错误（比如端口被占用）不会被回调函数捕获，必须额外通过server.on('error', ...)监听，要是没加这一步，错误会静默失败或者直接崩进程，排查起来非常头疼。

2. 流程控制的灵活性

• 写法1：返回Promise后，你可以在其他场景复用这个启动逻辑——比如在自动化测试中，你可以await startServer()，确保服务器完全启动后再执行测试用例，避免测试跑早了连不上服务的问题。
• 写法2：没有返回值，外部代码根本没法知道服务器到底有没有启动完成，要是有依赖启动状态的逻辑（比如定时任务、其他服务的联动），就完全没法控制时序。

第二种写法会不会引发问题？ #

答案是：如果不补全错误处理，肯定会出问题。如果一定要用写法2，必须补上完整的错误捕获逻辑，比如：

async function startServer() {
  try {
    await connectToDatabase();
    
    const app = express();
    app.get('/', (req, res) => res.send('Hello World!'));

    const server = app.listen(3000, () => {
      console.log('✅ 服务器在3000端口启动成功');
    });

    // 监听listen本身的错误
    server.on('error', (err) => {
      console.error('❌ 服务器启动出错:', err);
      process.exit(1);
    });
  } catch (err) {
    // 捕获初始化阶段的错误
    console.error('❌ 初始化失败:', err);
    process.exit(1);
  }
}

startServer();

总结建议 #

优先选择写法1，它不仅能统一处理所有启动阶段的错误，还能提供更灵活的流程控制，不管是日常开发还是自动化测试都更省心。如果因为某些原因要用写法2，一定要记得补全所有的错误捕获逻辑，别让潜在的问题悄悄埋在代码里。

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