PgBouncer配置：解决"no such database"连接错误问题

在使用PgBouncer作为PostgreSQL连接池时，开发者可能会遇到"no such database"的连接错误。这种情况通常发生在应用程序尝试连接未被明确配置的数据库时。本文将深入分析这一问题的成因，并提供多种解决方案。

问题现象分析

当应用程序通过PgBouncer连接PostgreSQL时，如果出现类似以下的错误日志：

login failed: db=postgres user=odoo
closing because: no such database: postgres

这表明PgBouncer无法识别或路由到请求的数据库。值得注意的是，这种错误通常只发生在尝试连接未被明确配置的数据库时，而已经配置的数据库连接则工作正常。

根本原因

PgBouncer的[databases]配置段定义了它能够识别的数据库映射。当配置中只列出了特定数据库（如示例中的mandaladb）时，PgBouncer会拒绝所有其他数据库的连接请求，包括PostgreSQL默认的postgres数据库。

解决方案

方案一：使用通配符配置

最简洁的解决方案是在配置中使用*通配符：

[databases]
* = host=fhcaredb port=5432 auth_user=odoo

这种配置方式会将所有数据库请求都路由到指定的后端服务器。优点是配置简单，无需为每个数据库单独设置。

方案二：显式列出所有需要的数据库

如果需要更精细的控制，可以显式列出所有需要连接的数据库：

[databases]
mandaladb = host=fhcaredb port=5432 auth_user=odoo
postgres = host=fhcaredb port=5432 auth_user=odoo

这种方式适合需要限制访问特定数据库的场景。

实际应用建议

对于像Odoo这样的应用框架，通常会需要连接多个数据库（包括系统数据库）。在这种情况下：

1. 如果应用架构允许，使用通配符配置是最简单可靠的方式
2. 结合应用层的数据库过滤(dbfilter)功能，可以避免用户需要手动选择数据库
3. 在生产环境中，建议同时配置监控，确保所有必要的数据库连接都能正常工作

配置验证

修改配置后，应该：

1. 重启PgBouncer服务使配置生效
2. 使用psql或其他客户端工具测试连接
3. 检查PgBouncer日志确认没有错误信息

通过合理配置PgBouncer的数据库映射，可以确保应用程序能够顺利连接到所有需要的数据库，同时保持连接池的高效管理。