Traefik添加PathPrefix后Rest API无法返回值的问题排查

问题核心在于：当使用PathPrefix(/first)规则时，Traefik默认会把**完整请求路径（包含前缀）**转发给后端API服务。你的后端API仅配置了/api/version路由，自然匹配不到/first/api/version路径，因此返回Not Found。

无需修改API路由设置，只需正确配置Traefik的StripPrefix中间件即可解决问题，具体步骤如下：

1. 修改第一个API服务的Docker Compose标签 #

给first-rest-service添加StripPrefix中间件配置，让Traefik转发请求前移除/first前缀：

services:
  first-rest-service:
    image: first-rest-service:latest
    container_name: first-rest-service
    restart: unless-stopped
    labels:
      - "traefik.http.routers.first-rest-service.rule=Host(`localhost`) && PathPrefix(`/first`)"
      # 将中间件关联到当前路由
      - "traefik.http.routers.first-rest-service.middlewares=first-rest-strip"
      # 创建StripPrefix中间件，指定要移除的前缀
      - "traefik.http.middlewares.first-rest-strip.stripprefix.prefixes=/first"
      - "traefik.http.services.first-rest-service.loadbalancer.server.port=8000"

2. 第二个API服务同理配置 #

第二个服务只需修改中间件名称和对应前缀即可：

services:
  second-rest-service:
    image: second-rest-service:latest
    container_name: second-rest-service
    restart: unless-stopped
    labels:
      - "traefik.http.routers.second-rest-service.rule=Host(`localhost`) && PathPrefix(`/second`)"
      - "traefik.http.routers.second-rest-service.middlewares=second-rest-strip"
      - "traefik.http.middlewares.second-rest-strip.stripprefix.prefixes=/second"
      - "traefik.http.services.second-rest-service.loadbalancer.server.port=8000" # 注意端口与你的服务匹配

3. 验证效果 #

重启所有容器后，再次发起请求：

curl http://localhost/first/api/version

此时Traefik会自动移除/first前缀，将/api/version转发给后端服务，就能得到正确返回：

{"version":"x.x.x"}

关于是否修改API路由的说明 #

虽然也可以修改API路由，让它支持带前缀的路径（比如把路由改成/first/api/version），但这种方式会让API路由与部署环境强耦合——后续更换前缀或部署到不同环境时，都需要修改API代码并重新构建镜像。相比之下，使用Traefik的StripPrefix中间件更灵活，完全通过配置实现路径转发，无需改动业务代码。

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