启用LoadBalancer后无法访问带/api前缀的API路径问题咨询

问题排查及解决方法 #

路径重写配置问题 #

• 问题根因：绝大多数负载均衡的路径匹配规则默认仅做流量转发，不会自动修改请求路径，会将完整的/api/xxx路径原样传递给后端服务。如果你的API服务没有配置带/api前缀的路由，或者实际监听在根路径，就会返回404或无响应。
• 验证方式：直接登录后端实例本地执行curl http://127.0.0.1/api/测试接口路径，如果本地调用带/api前缀也无响应，即可确认是该问题。
• 解决方法：在负载均衡的/api/*转发规则中添加路径重写配置，将匹配到的路径前缀/api/替换为/，或者替换为后端API实际使用的路径前缀。

规则优先级配置错误 #

• 问题根因：负载均衡的路径匹配规则按优先级从高到低生效，如果你配置的默认根路径/*规则优先级高于/api/*规则，所有请求都会优先匹配到根路径对应的后端组，不会触发/api/*的转发规则。
• 验证方式：查看监听器的规则排序，确认/api/*规则的优先级高于默认根路径规则。
• 解决方法：调整规则优先级，将/api/*规则调整到默认根路径规则之前。

后端目标组端口不匹配 #

• 问题根因：如果你的API服务和网站服务监听在不同端口（比如网站用80端口，API用8080端口），但/api/*规则绑定的后端目标组仍使用网站的80端口，请求转发到网站服务后找不到对应路由，就会无响应。
• 验证方式：核对API服务实际监听的端口，和/api/*规则绑定的目标组端口是否一致。
• 解决方法：创建独立的后端目标组，端口设置为API实际监听的端口，再将/api/*规则绑定到该目标组。

安全组/网络ACL拦截 #

• 问题根因：后端实例的安全组或所在子网的网络ACL仅放通了网站端口的负载均衡访问，没有放通API端口的访问，导致负载均衡转发的API请求被拦截。
• 验证方式：检查后端实例安全组的入站规则，确认允许负载均衡的网段访问API对应的端口。
• 解决方法：添加入站规则，源地址填负载均衡的CIDR段，端口为API实际监听的端口，协议选择TCP，设置为允许。

请求方法/CORS限制 #

• 问题根因：如果负载均衡配置了仅允许GET/POST等部分请求方法通行，或者API服务没有配置正确的CORS规则，前端跨域请求会被拦截，表现为无响应。
• 验证方式：用curl -v http://www.example.com/api/测试接口路径执行请求，查看返回的状态码和报错信息；如果是前端请求，查看浏览器控制台的跨域报错提示。
• 解决方法：如果是请求方法拦截，调整负载均衡监听器配置，放行API需要的请求方法；如果是CORS问题，在API服务中配置允许的请求源、请求头和请求方法。

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