https.createServer监听返回undefined错误如何排查具体原因？

Node.js 中 https.createServer().listen() 方法的回调为服务器启动成功后的触发回调，默认不会传入错误参数，这是你控制台打印结果为 undefined 的直接原因。

获取错误详情的方法 #

• 监听HTTPS服务实例的 error 事件，捕获服务启动阶段的错误：

const httpsServer = https.createServer(options, app);
// 捕获服务启动/运行的核心错误
httpsServer.on('error', (err) => {
  console.error('HTTPS服务错误：', err);
  console.error('错误标识码：', err.code);
});
httpsServer.listen(443, () => {
  console.log('HTTPS服务已成功监听443端口');
});

• 若需要捕获客户端与服务端建立连接阶段的异常，可监听 clientError 事件：

httpsServer.on('clientError', (err, socket) => {
  console.error('客户端连接异常：', err);
  socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
});

常见触发错误的原因 #

• 端口权限问题：443属于系统特权端口，Linux、macOS系统下非root用户默认无监听权限，对应错误码为EACCES
• 端口占用问题：443端口已被其他服务（如Nginx、Apache、其他HTTPS服务）占用，对应错误码为EADDRINUSE
• 证书配置错误：options中配置的PEM证书/密钥路径错误、格式损坏、密钥密码不匹配、证书已过期等，常见错误提示包括PEM routines:get_name:no start line（PEM文件无效）、bad password read（密钥密码错误）
• 系统网络限制：防火墙规则拦截443端口绑定、系统网络配置禁用了对应端口的监听权限

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