解决pgweb在Kubernetes中启用TLS后静态资源加载失败问题

问题背景

pgweb是一个基于Web的PostgreSQL数据库管理工具。在Kubernetes环境中部署pgweb时，开发者可能会遇到一个特殊问题：当在Ingress配置中启用TLS后，虽然主页面可以正常加载，但部分静态资源（特别是JavaScript文件）无法正确加载。

问题现象

具体表现为：

• 通过HTTPS访问pgweb时，HTML主页面可以正常加载
• CSS等静态资源可以正常下载
• JavaScript文件请求返回NULL，没有HTTP响应码
• 浏览器控制台显示net::ERR_HTTP2_SERVER_REFUSED_STREAM错误

问题分析

经过深入排查，发现问题的根源在于HTTP/2协议的支持上。当Ingress启用TLS后，默认会尝试使用HTTP/2协议进行通信。然而在某些Nginx Ingress Controller配置下，HTTP/2的资源推送机制可能与pgweb的静态资源服务方式存在兼容性问题。

解决方案

临时解决方案

通过在Ingress的ConfigMap中禁用HTTP/2协议可以立即解决问题：

data:
  use-http2: "false"

这种方法简单有效，但会牺牲HTTP/2带来的性能优势。

长期优化方案

1. 检查Nginx Ingress Controller版本：确保使用最新稳定版本的Ingress Controller，因为较新版本对HTTP/2的支持更加完善。

2. 调整HTTP/2参数：可以尝试调整以下参数来优化HTTP/2行为：

   data:
     http2-max-field-size: "16k"
     http2-max-header-size: "32k"
     http2-max-requests: "1000"
   

3. 资源预加载优化：在HTML头部添加预加载提示，帮助浏览器更高效地获取关键资源：

   <link rel="preload" href="/static/js/main.js" as="script">
   

4. CDN集成：考虑将静态资源托管到CDN，减轻Ingress的负担。

最佳实践建议

1. 渐进式TLS启用：在启用TLS前，先在非生产环境充分测试所有功能。

2. 全面监控：实施全面的应用性能监控，及时发现类似资源加载问题。

3. 多浏览器测试：确保在Chrome、Firefox和Safari等主流浏览器中都能正常工作。

4. 资源压缩：启用Gzip/Brotli压缩，减少传输数据量。

总结

pgweb在Kubernetes环境中启用TLS后出现的静态资源加载问题，主要源于HTTP/2协议的兼容性问题。通过调整Nginx Ingress Controller的配置参数，特别是HTTP/2相关设置，可以有效解决这一问题。建议开发者在实施此类变更时，采取渐进式策略，并建立完善的监控机制，确保应用服务的稳定性和性能。