EJS项目中如何配置让index.ejs优先于chat.ejs展示为默认首页

1. 优先排查路由注册规则 #

Express 框架的路由匹配遵循从上到下逐行匹配、命中即返回的规则，这是90%以上该类异常的诱因，常见错漏包括：

• 根路径/的渲染指向配置错误
  检查入口文件中根路径对应的渲染逻辑，确认是否抄模板时误将index.ejs写成了chat.ejs，正确配置参考：

  // 根路径默认渲染index.ejs
  app.get('/', (req, res) => {
    res.render('index')
  })
  // 聊天子页面单独绑定/chat路径
  app.get('/chat', (req, res) => {
    res.render('chat')
  })
  

• 路由匹配逻辑写反或顺序错误
  如果配置了动态参数路由（比如app.get('/:page', ...)这类通配规则），确认逻辑分支里是否把chat分支的优先级放得过高，导致访问根路径时也命中了chat的渲染分支；如果配置了app.get('*', ...)的全量通配路由，一定要把它放在所有精确路由的后面——很多开发者图方便把通配路由写在文件最顶部，直接拦截所有请求优先返回chat页面。

2. 核对EJS视图引擎的初始化配置 #

确认项目入口里的EJS初始化参数不存在错配，标准配置如下：

const path = require('path')
// 注册EJS模板引擎
app.set('view engine', 'ejs')
// 指定模板文件存放的根目录，不要错配到chat.ejs所在的子目录
app.set('views', path.join(__dirname, 'views'))

部分脚手架自动生成的项目可能会把默认渲染的模板写死为chat.ejs，逐行检查app.render相关的全局默认配置即可修正。

3. 检查静态资源中间件的注册顺序 #

express.static静态托管中间件会优先匹配文件系统中存在的同名文件，如果把静态中间件的注册位置放在动态视图路由前面，一旦静态目录下存在与路径同名的文件，会直接返回静态内容，绕过视图渲染逻辑。
调整为标准顺序：

• 先注册所有动态视图路由
• 最后注册静态资源托管规则

4. 排除环境缓存干扰 #

如果以上配置全部校验无误仍存在异常，可以依次排查：

• 重启本地Node开发服务
• 硬刷新浏览器、清除站点本地缓存
• 检查当前端口是否被其他残留的旧服务进程占用

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