部署在Kubernetes中由Nginx提供服务的应用Favicon无法显示问题

先核对Nginx配置的一致性 #

• 别默认K8s里的配置和本地Docker完全一致，先进入Pod查看实际生效的配置：执行kubectl exec -it <你的Pod名称> -- cat /etc/nginx/conf.d/default.conf，对比本地的favicon配置块。
  • 本地能用的alias配置到K8s失效，大概率是容器内文件路径不匹配——进入Pod执行ls /usr/share/nginx/html/，确认favicon.ico是否存在于配置指定的路径下。
  • 嫌alias容易踩路径坑的话，直接换用root配置更稳妥：

    location = /favicon.ico {
        root /usr/share/nginx/html;
        expires 1d;
        access_log off;
    }
    

    root是基于指定目录拼接请求路径，比alias的直接路径替换逻辑更不容易出错。

检查镜像与K8s资源配置 #

• 确认K8s拉取的镜像是不是你本地改完配置后重新构建的版本，别用latest标签踩新旧镜像混淆的坑，给镜像打明确的版本号更靠谱。
• 如果是用ConfigMap挂载Nginx配置，直接查看ConfigMap内容：kubectl get configmap <你的ConfigMap名称> -o yaml，核对里面的favicon配置是否和本地一致，以及挂载路径是否正确。

排除Ingress干扰（如果用到了Ingress） #

• 绕开Ingress，直接通过Pod的NodePort或ClusterIP访问http://<节点IP>:<NodePort>/favicon.ico，如果能正常获取文件，说明是Ingress的路径规则拦截了请求，需要调整Ingress的路径配置。

验证React打包环节 #

• 本地先执行npm run build，查看build目录里是否存在favicon.ico——React默认会把public目录下的静态文件复制到build根目录，但如果自定义过webpack配置，可能遗漏了这个文件的复制逻辑。
• 打开build目录里的index.html，确认favicon的引用是<link rel="icon" href="/favicon.ico" />，别用相对路径，否则路由切换后请求路径会出错。

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