Node.js：根据请求路径动态设置EJS视图与布局的优化方案咨询

你当前通过app.set()全局修改视图目录和布局的方式，在多用户并发访问不同路由时会因为全局状态被覆盖，导致视图渲染错误。以下是几个可行的替代方案：

方案一：在res.render时动态指定视图路径与布局 #

放弃全局修改views配置，转而在每次渲染时手动传入对应模块的视图路径和布局参数，或者封装一个自定义渲染方法简化操作。

假设你使用express-ejs-layouts处理布局，可按如下方式修改中间件：

app.use((req, res, next) => {
  const segments = req.path.split('/');
  const basePath = segments[1];
  
  let viewDir, layoutPath;
  switch (basePath) {
    case 'admin':
      viewDir = path.join(__dirname, 'views/admin');
      layoutPath = '../layouts/admin'; // 路径可相对视图目录或使用绝对路径
      break;
    case 'user':
      viewDir = path.join(__dirname, 'views/worker');
      layoutPath = '../layouts/worker';
      break;
    case 'guest':
      viewDir = path.join(__dirname, 'views/user');
      layoutPath = '../layouts/user';
      break;
    default:
      viewDir = path.join(__dirname, 'views/def');
      layoutPath = '../layouts/def';
      break;
  }
  
  // 封装自定义渲染方法，自动拼接视图路径和布局
  res.customRender = (viewName, data = {}) => {
    const fullViewPath = path.join(viewDir, viewName);
    return res.render(fullViewPath, {
      ...data,
      layout: layoutPath
    });
  };
  
  next();
});

在路由中直接调用自定义方法即可：

app.get('/admin/dashboard', (req, res) => {
  res.customRender('dashboard', { title: 'Admin Dashboard' });
});

方案二：拆分路由模块（Router）独立配置视图 #

将不同模块的路由拆分为独立的express.Router实例，每个Router单独处理对应模块的视图路径和布局，避免全局状态干扰。

示例：创建Admin模块路由

const adminRouter = express.Router();

// Admin路由专属中间件，设置布局
adminRouter.use((req, res, next) => {
  res.locals.layout = path.join(__dirname, 'views/layouts/admin');
  next();
});

// 渲染时直接使用Admin视图目录的相对路径
adminRouter.get('/dashboard', (req, res) => {
  res.render(path.join(__dirname, 'views/admin/dashboard'), { title: 'Admin Dashboard' });
});

// 注册到主应用
app.use('/admin', adminRouter);

同理可创建user、guest等模块的Router，每个Router的视图配置仅对自身路由生效，并发场景下不会互相覆盖。

方案三：自定义EJS视图引擎动态解析路径 #

通过自定义视图引擎，根据当前请求的路径自动匹配对应模块的视图目录，无需在路由中重复指定路径。

const ejs = require('ejs');

// 自定义EJS引擎，动态替换视图路径
app.engine('ejs', (filePath, options, callback) => {
  const segments = options.req.path.split('/');
  const basePath = segments[1];
  
  let viewDir;
  switch (basePath) {
    case 'admin':
      viewDir = path.join(__dirname, 'views/admin');
      break;
    case 'user':
      viewDir = path.join(__dirname, 'views/worker');
      break;
    case 'guest':
      viewDir = path.join(__dirname, 'views/user');
      break;
    default:
      viewDir = path.join(__dirname, 'views/def');
      break;
  }
  
  // 拼接实际视图文件路径
  const actualFilePath = path.join(viewDir, filePath);
  // 调用原生EJS渲染方法
  ejs.renderFile(actualFilePath, options, callback);
});

// 中间件动态设置布局
app.use((req, res, next) => {
  const segments = req.path.split('/');
  const basePath = segments[1];
  
  let layoutPath;
  switch (basePath) {
    case 'admin':
      layoutPath = path.join(__dirname, 'views/layouts/admin');
      break;
    case 'user':
      layoutPath = path.join(__dirname, 'views/layouts/worker');
      break;
    case 'guest':
      layoutPath = path.join(__dirname, 'views/layouts/user');
      break;
    default:
      layoutPath = path.join(__dirname, 'views/layouts/def');
      break;
  }
  res.locals.layout = layoutPath;
  next();
});

app.set('view engine', 'ejs');

路由中正常调用res.render即可，引擎会自动根据请求路径匹配视图目录：

app.get('/admin/dashboard', (req, res) => {
  res.render('dashboard', { title: 'Admin Dashboard', req: req }); // 需传入req供引擎解析路径
});

内容的提问来源于stack exchange，提问作者Isak Grönlund