Express.js 根路径"/"无法正常工作的问题排查求助

你的根路径/返回空白页面，核心原因是**express.static静态文件中间件的优先级高于自定义路由**。

当你访问/时，Express会先尝试通过express.static匹配public目录下的默认索引文件（比如index.html）。如果该目录下存在一个空的index.html，就会直接返回这个空白文件，完全跳过你后续定义的app.get('/')路由。而/hello路径没有对应的静态文件，所以会正常执行你的路由回调。

解决方法 #

方法1：移除冲突的静态索引文件 #

检查项目根目录下的public文件夹，找到并删除其中的index.html（或其他可能被静态服务器识别为默认索引的文件，比如index.htm）。重启服务器后访问/即可看到"Hello"。

方法2：修改静态中间件配置 #

如果你需要保留public目录下的索引文件，但仍希望自定义根路径响应，可以修改express.static的配置，禁用默认索引文件匹配：

app.use(express.static(path.join(__dirname, 'public'), { index: false }))

方法3：调整中间件顺序（不推荐） #

把express.static中间件的定义移到所有路由之后，这样自定义路由会先被匹配：

// 先定义所有路由
app.get('/hello' , (req, res, next) => {
    res.send('Hello from hello');
})

app.get('/', (req, res, next) => {
    res.send('Hello')
})

// 再挂载静态文件中间件
app.use(express.static(path.join(__dirname, 'public')))

注：这种方式不推荐，因为静态文件通常需要优先处理以提升性能，且不符合常规Express项目的结构规范。

额外排查点 #

确认__dirname指向的是你的项目根目录，避免public目录路径错误导致的意外匹配。可以在代码中添加一行日志验证：

console.log('Public directory path:', path.join(__dirname, 'public'));

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