UI5+Node.js多端点应用拆分路由后URL无法访问如何解决

问题场景 #

开发包含多个端点的UI5+Node.js应用时，将接口从入口文件拆分到独立路由文件后，对应路径无法被识别、接口不生效。

单文件运行正常的示例 #

在入口文件server.js中直接编写接口逻辑时，服务可正常响应：

app.get('/TwoWonders', function (req, res) {
    var items = [
        {name: 'Example1', location: 'Rome'},
        {name: 'Example2', location: 'Greece'}
    ]
    res.send(items);
});

启动服务后访问localhost:3000/TwoWonders，可正常获取接口返回的内容。

故障表现 #

将TwoWonders接口逻辑迁移拆分到独立文件wonders.js后，预期访问地址为localhost:3000/wonders/TwoWonders，但实际访问该路径时提示无法识别，接口不生效，暂未定位到有效解决方法。 #

正确配置步骤 #

按照Express框架的路由挂载规则，完成两步配置即可让拆分后的路由正常生效：

• 配置独立路由文件wonders.js
  不要在路由文件里直接使用入口文件的app实例，需要初始化独立的Router实例编写接口，最后导出实例：

  // wonders.js
  const express = require('express');
  const router = express.Router();
  
  // 接口路径写相对路径即可，不需要重复加/wonders前缀
  router.get('/TwoWonders', (req, res) => {
      const items = [
          {name: 'Example1', location: 'Rome'},
          {name: 'Example2', location: 'Greece'}
      ];
      res.send(items);
  });
  
  // 导出路由实例供入口文件引用
  module.exports = router;
  

• 在入口文件server.js中挂载路由
  引入写好的路由文件，通过app.use()指定路由前缀完成挂载：

  // server.js
  const express = require('express');
  const app = express();
  // 引入拆分的路由文件
  const wondersRouter = require('./wonders');
  
  // 挂载路由，统一指定前缀为/wonders
  app.use('/wonders', wondersRouter);
  
  app.listen(3000, () => {
      console.log('服务已启动在3000端口');
  });
  

配置完成后重启服务，即可通过localhost:3000/wonders/TwoWonders正常访问接口。

常见配置错误排查 #

• 路由文件未初始化express.Router()实例，直接复用入口文件的app对象写接口，会导致路由无法被正确注册
• 入口文件挂载路由时未传入前缀参数，或前缀拼写错误，会导致实际访问路径和预期不一致
• 路由文件未通过module.exports导出路由实例，入口文件引入的内容为空，对应路由不会生效
• 路由文件内的接口路径重复写了前缀，比如写成router.get('/wonders/TwoWonders', ...)，最终实际访问路径会变成localhost:3000/wonders/wonders/TwoWonders，和预期路径不匹配

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