容器化部署Dify时，配置阿里云API-Key反复出现“Invalid API-key provided”错误。经核验，阿里云AccessKey有效，问题根源为PostgreSQL数据库连接数耗尽。本文梳理核心排查过程与解决方案。

一、故障场景

1. 环境：Dify通过Docker Compose部署，阿里云API-Key（sk-xxxxxxx）来自百炼控制台且验证有效。

2. 现象：输入API-Key配置模型时即时报错。

3. 排查入口：执行日志命令提取错误信息

cd 你的dify所在目录/docker sudo docker compose logs api

二、核心原因

PostgreSQL默认最大连接数（max_connections）为100，Dify主服务、plugin-daemon、插件及工作流并发占用连接，未及时释放导致连接池耗尽，引发：插件守护进程连接数据库失败→插件初始化异常→模型校验报错（误提示API-Key无效）。

关键报错：FATAL: sorry, too many clients already (SQLSTATE 53300)

三、故障佐证

日志核心信息确认连接问题：

failed to connect to `host=db user=postgres database=dify_plugin`: server error (FATAL: sorry, too many clients already (SQLSTATE 53300))

四、解决方案

方案A：扩大PostgreSQL最大连接数（根治）

1. 编辑docker-compose.yml，在db服务环境变量添加配置：

services: db: image: postgres:14 environment: POSTGRES_DB: dify POSTGRES_USER: postgres POSTGRES_PASSWORD: xxx # 替换实际密码 POSTGRES_MAX_CONNECTIONS: 500 # 推荐值 volumes: - postgres-data:/var/lib/postgresql/data

2. 若镜像不支持环境变量配置：

- 新建postgres.conf，写入：max_connections = 500

- 挂载配置文件，修改docker-compose.yml的db服务volumes：

volumes: - postgres-data:/var/lib/postgresql/data - ./postgres.conf:/etc/postgresql/postgresql.conf

3. 重启服务：

docker compose down

docker compose up -d

方案B：限制plugin-daemon连接池（优化）

1. 编辑Dify部署目录.env文件（无则创建）：

PLUGIN_DATABASE_POOL_SIZE=5

PLUGIN_DATABASE_MAX_OVERFLOW=2

2. 重启服务：

docker compose restart plugin-daemon

方案C：清理闲置连接（应急）

1. 进入PostgreSQL容器：

docker exec -it dify-db bash # dify-db为容器名，docker ps查询

2. 登录数据库：

psql -U postgres

3. 终止非当前会话连接：

SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE pid <> pg_backend_pid();

五、排查启示

容器化应用组件依赖紧密，故障排查需穿透表面报错，优先提取核心服务日志（Dify api、PostgreSQL），通过错误链路追溯根源。