Odoo 的每项工作都依赖应用服务器与 PostgreSQL 之间可靠的连接。数据库连接配置错误会导致无法启动、超时、认证失败、性能差甚至更严重问题。Odoo 19 仍使用 PostgreSQL连接参数主要写在odoo.conf。python3 odoo-bin-c/etc/odoo.conf1. 核心参数[options] db_host localhost db_port 5432 db_user odoo db_password admin db_name False参数含义db_hostlocalhost表示同机否则为远程库 IP/主机名db_port默认5432也可自定义如5433db_userOdoo 专用数据库用户不要用 postgres 超级用户db_password对应用户密码——生产请用强密码db_nameFalse显示选库界面或强制连某一个库名远程主机生产常把 PostgreSQL 放在另一台机器扩展、安全、独立资源、备份。若出现 Connection refused检查 PG 是否运行、防火墙/5432以及 postgresql.conf 中的 listen_addresses必要时如listen_addresses *。创建专用用户示例sudo-upostgres createuser-sodoosudo-upostgres psql-cALTER USER odoo WITH PASSWORD admin;保护配置文件chmod640/etc/odoo.confchownodoo:odoo /etc/odoo.confdb_name与dbfilterdb_name False— 选库 / 多库db_name production_db— 自动连指定库dbfilter ^mycompany.*$— 只显示匹配的库dbfilter ^%d$— 按域名erp.company.com → 库 erp常见多租户2. 连接池db_maxconndb_maxconn 64限制 Odoo 到 PostgreSQL 的连接数。超过 PG 的 max_connections 会出现FATAL: remaining connection slots are reserved / too many clients already需结合 Worker 估算例如 4 workers × 16 ≈ 64。若使用 PgBouncer/PgPool池参数主要在中间件侧配置。3. 模板与 SSLdb_template template0新建库建议用template0环境更干净template1 可能带历史对象。默认连接未加密生产应通过 PostgreSQL SSL、专网和/或 VPN 加固在服务端/网络侧配置。4. 示例配置单机 / 固定库 — 见odoo.conf.single_server.sample多库 域名过滤 —odoo.conf.multi_db_domain.sample远程 PostgreSQL —odoo.conf.remote_postgres.sample5. 修改后验证sudosystemctl restart odoosudojournalctl-uodoo-fpsql-hlocalhost-Uodoo-dpostgres# 本机psql-h10.0.0.15-Uodoo-dpostgres# 远程监控连接SELECT*FROMpg_stat_activity;6. 常见错误错误检查项Password authentication failed密码、用户、pg_hba.confDatabase does not existpsql -U postgres -lToo many clients alreadydb_maxconn、PGmax_connections、Worker 数Timeout expired网络、防火墙、主机/端口7. 最佳实践为 Odoo 使用专用 PostgreSQL 用户收紧 odoo.conf 权限多库时使用 dbfilter生产尽量将库与应用分机若条件允许不要把 5432 暴露到公网