Magento2部署于Docker+K8s环境，/admin报502 Bad Gateway错误求助

一、先排查Kubernetes集群基础状态 #

• 检查Pod运行状态：执行kubectl get pods -n <你的命名空间>，确认Magento相关Pod（web、php-fpm若分离部署）处于Running状态，无重启或CrashLoopBackOff。若有异常，查看Pod启动日志：kubectl logs <pod-name> -n <命名空间>，容器启动阶段的报错可能藏着线索。
• 验证Service关联：执行kubectl describe service <magento-service-name> -n <命名空间>，确认Endpoints里有正常的Pod IP，端口映射符合预期（比如web容器的80/443、php-fpm的9000端口）。
• 检查Ingress配置：确认Ingress的rules中/admin路径正确指向对应Service，同时检查Ingress Controller的Pod是否正常运行。执行kubectl describe ingress <ingress-name> -n <命名空间>，看Events栏有没有配置错误或连接失败的日志。

二、验证容器内部应用可用性 #

• 直接在Web容器内测试：kubectl exec -it <web-pod-name> -n <命名空间> -- bash，然后执行curl localhost/admin，如果容器内访问正常，问题大概率在Ingress或集群网络；如果容器内也返回502，检查Web服务器（比如nginx）配置，确认是否正确转发请求到php-fpm（分离部署的话，要确保php-fpm的Service地址配置无误）。
• 检查php-fpm状态（分离部署场景）：进入php-fpm容器，执行php-fpm -t验证配置合法性，或者用curl <php-fpm-service-name>:9000/ping（需提前配置ping路径）确认服务存活。

三、Magento自身配置排查 #

• 确认base URL配置：执行kubectl exec -it <web-pod-name> -n <命名空间> -- bin/magento config:show web/unsecure/base_url和web/secure/base_url，确保URL和Ingress暴露的域名完全一致，没有错误的路径或端口。
• 检查admin路由注册：在容器内执行bin/magento info:routes | grep admin，确认admin路由已正常注册。
• 验证文件权限：Magento的pub/static、var目录需要Web服务器用户（比如www-data）拥有读写权限，执行ls -l pub/static/和ls -l var/确认权限正确，必要时执行bin/magento setup:static-content:deploy -f重新部署静态文件。

四、网络连通性排查 #

• 从Ingress Controller测试连通性：kubectl exec -it <ingress-controller-pod> -n <ingress-namespace> -- curl <magento-service-name>.<your-namespace>.svc.cluster.local/admin，看是否能正常返回内容，排查Ingress到Service的链路是否通畅。
• 检查NetworkPolicy：如果集群配置了NetworkPolicy，确认允许Ingress Controller与Magento Pod、Magento Pod与php-fpm Pod（分离部署）之间的通信。

五、日志排查技巧 #

• 查看Ingress Controller日志：比如nginx-ingress的日志kubectl logs <nginx-ingress-pod> -n <ingress-namespace>，这里往往会记录502的具体原因（比如连接超时、拒绝连接），比Magento应用日志更有参考价值。
• 启用Magento调试日志：在容器内修改app/etc/env.php，添加'debug' => ['enabled' => true, 'file' => 'debug.log']，再次访问/admin后查看var/log/debug.log是否有相关记录。

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