Express.js的sendFile函数在Linux环境下无法正常工作的问题

核心问题分析 #

你的代码存在两个关键问题，结合Linux系统特性共同导致页面空白：

1. res.end()调用时机错误：res.sendFile是异步方法，提前调用res.end()会中断文件发送流程，导致响应不完整。
2. Linux系统特性差异：大小写敏感、文件权限限制，这两点是Windows与Linux的核心区别，也是此类问题的常见诱因。

解决方案步骤 #

1. 修正异步处理逻辑

移除手动调用的res.end()，并添加错误回调捕获问题原因：

const path = require("path")
const express = require("express")

// 声明const避免全局变量污染
const app = express()

app.get("/", (req, res) => {
    const fullpath = path.join(__dirname, 'index.html')
    console.log("目标文件路径:", fullpath)
    
    // 添加错误回调，明确捕获发送失败的具体原因
    res.sendFile(fullpath, (err) => {
        if (err) {
            console.error("文件发送失败:", err)
            res.status(err.status || 500).send("页面加载失败")
        } else {
            console.log("文件发送成功")
        }
    })
    // 无需手动调用res.end()，Express会在sendFile完成后自动结束响应
})

app.listen(5500, () => {
    console.log("服务器已启动，端口5500")
})

2. 排查Linux特有的问题

• 检查文件名大小写：Linux严格区分大小写，确保你的文件确实是index.html（而非Index.html、INDEX.HTML等）。
• 检查文件权限：确保Node进程拥有读取该文件的权限，执行以下命令查看并调整：

  # 查看文件权限详情
  ls -l index.html
  # 赋予文件可读权限（若权限不足）
  chmod 644 index.html
  

• 验证文件路径有效性：根据控制台打印的fullpath，手动执行命令确认文件存在且可读：

  cat /你的/完整/路径/index.html
  

快速验证响应链路 #

如果上述步骤未解决问题，可临时替换响应逻辑，验证服务器是否能正常返回内容：

app.get("/", (req, res) => {
    res.send("测试响应是否正常")
})

若能看到这段文字，说明问题确实出在文件读取环节，再针对性排查路径、权限或大小写问题。

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