Express无法识别未定义在Controller文件中的嵌套路由如何解决？

问题根本原因 #

Node.js 的模块代码只有在被主动导入时才会执行，你当前定义s3路由的文件从未被项目其他代码引用，文件内给AwsController添加/s3路由的逻辑根本没有运行，Express 自然无法识别该路由。

解决方案 #

方案1：最小改动快速修复 #

在AwsController定义文件的末尾，导入s3路由文件触发代码执行即可：

// services/aws 路径对应的代码文件
export const AwsController: Router = Router();

AwsController.get('/', (req, res) => {
  res.send('aws controller works');
});

// 新增这一行，导入s3文件执行里面的路由注册逻辑
import './s3';

该方案改动最小可以直接生效，缺点是后续子路由越多，需要添加的导入语句越多，扩展性一般。

方案2：标准嵌套路由模式（更推荐） #

每个子模块独立导出 Router 实例，父路由统一挂载，结构更清晰易维护：

1. 改造s3路由文件，导出独立的子路由实例：

// services/aws/s3 路径对应的代码文件
import { Router } from 'express';
export const S3Controller: Router = Router();

S3Controller.get('/', (req, res) => {
  res.send('s3 works');
});
// 所有s3相关的子路由都可以在该文件内单独维护

2. 在AwsController中挂载子路由：

// services/aws 路径对应的代码文件
export const AwsController: Router = Router();
import { S3Controller } from './s3';

AwsController.get('/', (req, res) => {
  res.send('aws controller works');
});

// 挂载s3子路由，前缀为/s3
AwsController.use('/s3', S3Controller);

后续新增其他 AWS 相关子路由（如 EC2、CloudFront 等），只需要新建对应模块导出路由，在AwsController中加一行挂载逻辑即可，完全解耦，也方便统一配置中间件、权限校验等逻辑。

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