Node.js Express应用无法渲染HTML文件，仅显示空白页面

我用Express开发一个简单Node.js应用，目标是返回views文件夹中的HTML文件，但访问页面时仅显示空白屏幕，无任何内容。

服务端代码 #

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

const app = express();
const port = 3000;

app.get('/', (req, res) => {
    res.sendFile(path.join(__dirname, 'views', 'index.html'));
});

app.listen(port, () => {
    console.log(`Server is running at http://localhost:${port}`);
});

HTML文件（views/index.html） #

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Test Page</title>
</head>
<body>
    <h1>Hello World!</h1>
    <p>This is a test page.</p>
</body>
</html>

问题细节 #

• 终端及浏览器控制台无任何错误提示
• 已尝试操作：
  • 确认服务器正常运行，可访问http://localhost:3000/
  • 检查文件路径是否正确
  • 使用极简HTML文件测试渲染
  • 怀疑Windows 10破解版可能影响应用运行

预期与实际表现 #

• 预期：浏览器显示「Hello World!」和「This is a test page.」文本
• 实际：页面完全空白，无任何内容

环境信息 #

• 操作系统：Windows 10（破解版）
• Node.js版本：20.17.0
• Express版本：4.21.1

排查与解决方案 #

1. 精准验证文件路径 #

在res.sendFile中添加错误回调，明确是否存在路径或文件读取问题：

app.get('/', (req, res) => {
    const filePath = path.join(__dirname, 'views', 'index.html');
    console.log('待读取文件路径:', filePath); // 打印路径到终端
    res.sendFile(filePath, (err) => {
        if (err) {
            console.error('文件发送错误:', err);
            res.status(err.status || 500).end();
        }
    });
});

运行后查看终端输出的路径是否匹配真实文件位置，以及是否有错误抛出。

2. 检查HTML文件完整性 #

• 重新创建一个干净的HTML文件替换原文件，避免原文件存在不可见字符、编码异常或标签未闭合问题
• 用记事本打开HTML文件，选择「另存为」，确认编码为UTF-8

3. 规避系统权限限制 #

破解版Windows可能存在文件权限异常，尝试：

• 将项目文件夹移至非系统盘（如D盘根目录），避开C盘的权限管控
• 以管理员身份启动终端，再运行Node服务

4. 验证路由基础功能 #

暂时替换res.sendFile为简单文本响应，确认路由逻辑正常：

app.get('/', (req, res) => {
    res.send('<h1>测试文本</h1>');
});

如果能正常显示文本，说明Express服务及路由无问题，问题集中在sendFile或文件本身。

5. 强制刷新浏览器缓存 #

按Ctrl+Shift+R强制刷新页面，避免浏览器缓存旧的空白响应

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