Node.js+Express中res.sendFile内部异常无法捕获，返回404求助

核心排查与解决步骤 #

1. 验证文件路径与可访问性 #

手动拼接路径并测试文件是否存在、可读取，排除路径错误或权限问题：

const fs = require('fs');
const path = require('path');
const filePath = path.join(__dirname, 'homepage.html');

fs.access(filePath, fs.constants.R_OK, (err) => {
  if (err) {
    console.error('文件无法访问:', err);
  } else {
    console.log('文件路径有效，可正常读取');
  }
});

2. 捕获sendFile同步阶段错误 #

res.sendFile的参数解析等同步操作可能抛出异常，用try/catch包裹调用：

app.get('/', (req, res) => {
  try {
    const sendResult = res.sendFile('homepage.html', { root: __dirname }, (err) => {
      if (err) {
        console.error('sendFile回调错误:', err);
      }
    });
    console.log('sendFile返回值:', sendResult); // 正常应返回res对象
  } catch (syncErr) {
    console.error('sendFile同步执行错误:', syncErr.stack);
  }
});

3. 使用Express官方错误处理中间件 #

替换uncaughtException，用Express推荐的全局错误中间件捕获异步错误：

// 需放在所有路由定义之后
app.use((err, req, res, next) => {
  console.error('Express全局错误详情:', err.stack);
  res.status(err.statusCode || 500).send('服务器内部错误');
});

4. 最小化环境测试 #

创建极简HTTPS服务器，排除其他中间件或路由干扰：

const express = require('express');
const https = require('https');
const fs = require('fs');
const path = require('path');

const app = express();

app.get('/', (req, res) => {
  const filePath = path.resolve(__dirname, 'homepage.html');
  res.sendFile(filePath, (err) => {
    if (err) {
      console.error('发送文件失败:', err);
      res.status(404).send('文件未找到');
    }
  });
});

app.use((err, req, res, next) => {
  console.error('全局错误:', err.stack);
  res.status(500).end();
});

// HTTPS配置
const sslOptions = {
  key: fs.readFileSync('./server.key'),
  cert: fs.readFileSync('./server.cert')
};

https.createServer(sslOptions, app).listen(443, () => {
  console.log('HTTPS服务器启动，端口443');
});

5. 检查Express版本兼容性 #

不同版本的sendFile参数或行为可能有差异，执行npm list express查看版本，若版本过旧，尝试升级至稳定版：

npm install express@latest --save

关键注意点 #

• 不要依赖uncaughtException处理Express异步错误，该事件仅用于捕获未处理的同步致命错误。
• res.sendFile正常情况下应返回res对象支持链式调用，若返回undefined，大概率是同步阶段参数解析或内部方法调用出错。

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