Express中res.sendFile()返回204无内容响应的问题排查

核心问题分析 #

你使用了NestJS装饰器（@httpGet、@response()），但手动调用Express的res.sendFile()时，和NestJS的响应处理机制发生冲突，导致响应被框架截断，返回204无内容。另外，sendFile是异步方法，原代码的try/catch无法捕获它的执行错误，你看不到具体失败原因。

分步解决 #

1. 先捕获sendFile的真实错误 #

给sendFile添加回调函数，打印具体错误，排查是否有隐藏问题（比如文件权限、路径解析异常）：

@httpGet('/pricereq')
async getAllPriceChangeReqs(@response() res: express.Response) {
  try {
    const data = await this.priceService.compilePriceChangeRequests();
    const imagePath = path.resolve(data);
    console.log(path.isAbsolute(imagePath));
    console.log(imagePath);
    // 添加回调捕获sendFile错误
    res.sendFile(imagePath, (err) => {
      if (err) {
        console.error('发送文件出错:', err);
        res.status(err.statusCode || 500).send({ error: err.message });
      }
    });
    // 不要return res.sendFile，避免NestJS拦截响应
  } catch (err) {
    return res.status(400).send({ error: err.message });
  }
}

2. 适配NestJS的响应机制（二选一） #

方案一：允许手动控制响应

修改@response()装饰器，添加passthrough: true，告诉NestJS不要自动处理响应，交给你手动操作：

import { Res } from '@nestjs/common';

@httpGet('/pricereq')
async getAllPriceChangeReqs(@Res({ passthrough: true }) res: express.Response) {
  try {
    const data = await this.priceService.compilePriceChangeRequests();
    const imagePath = path.resolve(data);
    res.sendFile(imagePath, (err) => {
      if (err) {
        console.error('发送文件失败:', err);
        res.status(err.statusCode || 500).send({ error: err.message });
      }
    });
  } catch (err) {
    res.status(400).send({ error: err.message });
  }
}

方案二：使用NestJS原生的文件返回方式（推荐）

用NestJS提供的StreamableFile，更符合框架规范，无需手动操作Express响应：

import { StreamableFile, BadRequestException } from '@nestjs/common';
import { createReadStream } from 'fs';
import * as path from 'path';

@httpGet('/pricereq')
async getAllPriceChangeReqs() {
  try {
    const data = await this.priceService.compilePriceChangeRequests();
    const imagePath = path.resolve(data);
    console.log(path.isAbsolute(imagePath));
    console.log(imagePath);
    const fileStream = createReadStream(imagePath);
    return new StreamableFile(fileStream);
  } catch (err) {
    throw new BadRequestException(err.message);
  }
}

3. 额外检查点 #

• 确认Node.js进程有读取目标文件的权限（Windows下一般没问题，但如果文件在受保护目录可能受限）
• 用fs.access(imagePath, fs.constants.R_OK, (err) => console.log(err))验证文件是否可读

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