Minikube部署Penpot时Backend无法连接PostgreSQL的问题

问题核心分析 #

你遇到的CrashLoopBackOff根源是Penpot后端无法解析PostgreSQL的主机名，两种配置错误的原因分别是：

• 使用PENPOT_DATABASE_URI时，Java解析逻辑错误地将penpot:penpot@postgres整体识别为主机名，导致UnknownHostException；
• 改用分离配置后，配置的主机名penpot-postgresql与集群中实际的PostgreSQL Service名称不匹配，无法通过Kubernetes DNS解析。

分步解决方案 #

1. 确认PostgreSQL Service的正确名称 #

先查看集群中PostgreSQL对应的Service名称：

kubectl get svc

• 如果是手动部署PostgreSQL，Service名通常是postgres；
• 如果是通过Helm部署（比如Bitnami的PostgreSQL Chart），若release名为penpot，Service名会是penpot-postgresql。

2. 修正数据库连接配置 #

推荐使用分离式环境变量配置（避免URI解析歧义），将Penpot后端的环境变量设置为：

PENPOT_DATABASE_USER: penpot
PENPOT_DATABASE_PASSWORD: penpot
PENPOT_DATABASE_HOST: <你的PostgreSQL Service名称>
PENPOT_DATABASE_PORT: 5432
PENPOT_DATABASE_NAME: penpot
PENPOT_DATABASE_SSL: false

若坚持使用URI格式，确保格式完全正确并禁用SSL（本地Minikube通常无需SSL）：

PENPOT_DATABASE_URI: postgresql://penpot:penpot@<你的PostgreSQL Service名称>:5432/penpot?sslmode=disable

3. 验证跨Namespace的DNS解析 #

如果Penpot和PostgreSQL不在同一个Namespace中，主机名需要加上Namespace后缀，格式为：

<service-name>.<namespace>.svc.cluster.local

例如PostgreSQL在default命名空间，Penpot在penpot命名空间，主机名应为postgres.default.svc.cluster.local。

4. 检查PostgreSQL自身状态 #

确保PostgreSQL Pod处于正常运行状态：

kubectl get pods

查看PostgreSQL日志确认数据库已初始化完成并接受连接：

kubectl logs <postgres-pod-name>

5. Helm部署的额外配置检查 #

若使用Helm部署Penpot，修改values.yaml中的数据库配置段，确保host与PostgreSQL Service名称一致：

database:
  host: <你的PostgreSQL Service名称>
  port: 5432
  user: penpot
  password: penpot
  name: penpot
  ssl: false

如果依赖Helm安装PostgreSQL，先确认依赖已正确部署：

helm dependency update
helm install penpot ./penpot-chart

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