Node.js中res.sendFile发送Temp目录PDF返回空文件问题求助

我来帮你搞定这个头疼的问题！你用Node.js的res.sendFile()返回Temp目录里的PDF却得到空文件，还没错误提示，大概率是这几个地方出了问题，咱们一步步排查：

1. 首先修正路径的致命错误 #

你写的os.tmpdir少了括号！os.tmpdir()是一个方法，不是直接的属性，直接用os.tmpdir得到的是函数引用，拼接出来的路径完全不对，自然找不到文件，而默认情况下sendFile找不到文件不会主动抛出错误，就返回了空内容。

正确的写法应该用path.join来处理路径（避免不同系统的路径分隔符问题）：

const path = require('path');
const os = require('os');

const pdfPath = path.join(os.tmpdir(), 'download', 'something.pdf');
res.sendFile(pdfPath);

2. 加上错误回调，捕获隐藏问题 #

之前你没给sendFile加回调函数，所以即使有错误也看不到。一定要加上回调，才能知道到底是文件不存在、权限不够还是其他问题：

res.sendFile(pdfPath, (err) => {
  if (err) {
    console.error('发送PDF时出错:', err);
    res.status(err.status || 500).send('无法获取PDF文件');
  }
});

3. 提前验证文件的存在性与可读性 #

可以在发送前先检查文件是否存在且可读，避免无效的发送操作：

const fs = require('fs');

fs.access(pdfPath, fs.constants.R_OK, (err) => {
  if (err) {
    console.error('文件不可读或不存在:', err);
    return res.status(404).send('PDF文件不存在');
  }
  res.sendFile(pdfPath, (err) => {
    // 这里处理发送错误
  });
});

4. 设置正确的Content-Type响应头 #

有时候浏览器因为没有收到正确的Content-Type，会把PDF解析成空白内容。可以手动指定响应头，确保浏览器识别这是PDF文件：

res.setHeader('Content-Type', 'application/pdf');
res.sendFile(pdfPath, (err) => {
  // 错误处理
});

或者通过sendFile的options参数设置：

res.sendFile(pdfPath, {
  headers: {
    'Content-Type': 'application/pdf'
  }
}, (err) => {
  // 错误处理
});

5. 检查临时目录的权限 #

某些系统的临时目录（比如Linux的/tmp）权限管控严格，要确保你的Node.js进程有读取/tmp/download/something.pdf的权限。如果是你生成的PDF文件，要确保生成时用的是当前进程的用户身份，避免权限不足。

先试试修正os.tmpdir()的括号问题，加上错误回调，应该就能解决大部分情况了！

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