Dart Shelf框架Cascade API中404错误响应头不一致问题

核心原因 #

Shelf的Cascade组件默认逻辑是：只要前一个handler返回状态码为404或405的响应，就会将请求传递给下一个handler。

你代码中的ApiA的/apia端点返回的是自定义404响应（状态码仍是404），Cascade会将其判定为“未处理请求”，继续把请求传给ApiB的Router。而ApiB的Router匹配不到/apia路径，返回框架默认的404响应，这是最后一个handler，所以最终返回的是这个默认响应。

而访问/apib时，ApiA的Router匹配不到路径，返回默认404，Cascade传给ApiB的Router，后者匹配到路径并返回自定义404，此时没有后续handler，所以返回这个自定义响应。

解决方案 #

方案1：自定义Cascade的判定逻辑

修改Cascade的shouldCascade参数，让它仅在响应是Router默认404时才继续传递请求：

void main() async {
  var apiAHandler = ApiA();
  var apiBHandler = ApiB();
  var cascadeHandler = Cascade(
    shouldCascade: (response) {
      // 仅当响应是默认404时才继续
      return response.statusCode == 404 &&
          response.readAsStringSync() == 'Route not found' &&
          !response.headers.containsKey('head-test');
    },
  ).add(apiAHandler.router).add(apiBHandler.router).handler;
  await shelf_io.serve(cascadeHandler, 'localhost', 8080);
  print('Server Online');
}

方案2：用Router的mount划分API路径（推荐）

如果你的目标是区分不同API的路径，更推荐用mount给每个API设置独立的路径前缀，避免Cascade的404传递问题：

1. 修改API类的路由为根路径：

class ApiA {
  Router get router {
    Router router = Router();
    router.get('/', (Request req) async {
      return Response.notFound('body test', headers: {'head-test': 'test'});
    });
    return router;
  }
}

class ApiB {
  Router get router {
    Router router = Router();
    router.get('/', (Request req) async {
      return Response.notFound('body test', headers: {'head-test': 'test'});
    });
    return router;
  }
}

2. 主函数中挂载路径前缀：

void main() async {
  var apiAHandler = ApiA();
  var apiBHandler = ApiB();
  final mainRouter = Router();
  // 给每个API挂载独立前缀
  mainRouter.mount('/apia', apiAHandler.router);
  mainRouter.mount('/apib', apiBHandler.router);
  await shelf_io.serve(mainRouter, 'localhost', 8080);
  print('Server Online');
}

此时访问/apia会触发ApiA的自定义404，访问/apib触发ApiB的自定义404，两者互不干扰。

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