Traefik路由规则异常：localhost/api请求未转发至后端容器

问题根源 #

1. 路由优先级冲突：你的Web服务路由规则Host(localhost)会匹配所有指向localhost的请求（包括/api路径的请求），因为它的规则更宽泛，Traefik默认会优先匹配这类通用规则。
2. 路径前缀未剥离：原Nginx配置中通过rewrite去掉了/api前缀，但当前Traefik配置没有做对应处理，导致后端API服务收到的请求路径仍带有/api，可能无法正确响应。

解决方案 #

修改api服务的Traefik标签，添加路由优先级和路径剥离中间件：

api:
  image: "myimagename"
  ports:
    - '5000'
  scale: 1
  labels:
    - "traefik.enable=true"
    - "traefik.http.routers.api.rule=Host(`localhost`) && PathPrefix(`/api`)"
    - "traefik.http.routers.api.entrypoints=web"
    # 增加优先级，确保/api路由先被匹配
    - "traefik.http.routers.api.priority=10"
    # 定义剥离/api前缀的中间件
    - "traefik.http.middlewares.api-stripprefix.stripprefix.prefixes=/api"
    # 为api路由绑定该中间件
    - "traefik.http.routers.api.middlewares=api-stripprefix@docker"
    - "traefik.http.services.api.loadbalancer.server.port=5000"
  # 其余配置保持不变

说明 #

• 优先级设置：priority=10让api路由的优先级高于默认优先级为0的web路由，Traefik会优先匹配/api开头的请求。
• 路径剥离中间件：stripprefix中间件会将请求路径中的/api前缀移除，和你原Nginx配置中的rewrite /api/(.*) /$1 break效果一致，确保后端API服务收到的是正确的路径（比如localhost/api/users会被转发为http://api/users）。

验证 #

修改后重启docker-compose服务：

docker-compose up -d

访问localhost/api时会正确转发到API后端容器，非/api路径的请求则会匹配到Web服务。

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