K8s集群中Docker容器连接PostgreSQL崩溃，求排查建议

1. 检查CPU架构兼容性 #

Mac M1是ARM64架构，K8s集群节点大概率为x86_64。若镜像构建未适配多架构，ARM版本的psycopg2（C扩展库）在x86节点运行会触发内存错误。

• 执行kubectl describe node <节点名称> | grep Architecture查看K8s节点CPU架构
• 执行docker inspect <镜像ID> | grep Architecture查看本地构建的镜像架构
• 解决：用docker buildx构建多架构镜像，或直接在x86机器上构建镜像后部署到K8s

2. 验证psycopg2与libpq的版本兼容性 #

psycopg2依赖系统的libpq库，K8s容器内的libpq版本可能和Mac本地存在差异，导致内存管理异常。

• 在容器内执行ldd $(pip show psycopg2 | grep Location | cut -d' ' -f2)/psycopg2/_psycopg.cpython-*.so查看依赖的libpq版本
• 对比本地容器的libpq版本（dpkg -l | grep libpq5）
• 解决：
  • 升级/降级psycopg2版本（如尝试2.9.7或3.0.17）
  • 在Dockerfile中明确安装指定版本的libpq-dev，例如：apt-get install -y libpq-dev=12.15-0ubuntu0.20.04.1

3. 检查容器内存资源限制 #

K8s中容器内存配额过低时，可能触发内存分配失败，表现为double free这类内存错误。

• 执行kubectl describe pod <Pod名称> | grep Resources查看当前内存请求和限制
• 对比本地运行容器的内存使用情况（docker stats）
• 解决：调高容器内存资源配置，例如：

  resources:
    requests:
      memory: "256Mi"
    limits:
      memory: "512Mi"
  

4. 核对系统库与内核版本差异 #

K8s节点的内核或系统库（如libc6）版本可能和Mac Docker虚拟机存在差异，导致C扩展运行异常。

• 在容器内执行uname -r查看内核版本，dpkg -l | grep libc6查看libc版本
• 对比本地容器的对应版本
• 解决：在Dockerfile中升级系统库（apt-get update && apt-get upgrade -y），或更换与K8s节点系统更匹配的基础镜像

5. 替换为psycopg2-binary包 #

psycopg2需要编译安装，依赖系统libpq；psycopg2-binary是预编译二进制包，自带libpq，可规避系统依赖不兼容问题。

• 修改Dockerfile，将pip install psycopg2==2.9.3替换为pip install psycopg2-binary==2.9.3
• 重新构建镜像并部署到K8s测试

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