Pydantic中PostgresDsn对无主机名URL的处理变更解析

在Pydantic 2.10版本中，PostgreSQL数据库连接字符串(PostgresDsn)的验证规则发生了一个重要变化，这个变化影响了使用Unix域套接字连接的PostgreSQL配置方式。

背景说明

PostgreSQL数据库连接字符串通常采用以下格式：

postgresql://username:password@hostname:port/database

但PostgreSQL还支持一种特殊格式，当省略主机名时，表示使用本地Unix域套接字连接：

postgresql:///dbname

这种格式在本地开发环境中非常常见，因为它避免了TCP/IP连接的开销，直接使用操作系统提供的进程间通信机制。

Pydantic 2.10版本的变化

在Pydantic 2.10之前，PostgresDsn类型会接受这种无主机名的连接字符串。但从2.10版本开始，由于底层验证逻辑的调整，这种格式会被拒绝，并抛出"Input should be a valid URL, empty host"错误。

这一变化源于Pydantic核心库对URL验证规则的强化，特别是对host_required参数的严格执行。虽然这提高了验证的严格性，但也影响了部分现有代码的正常运行。

解决方案

对于需要继续支持无主机名连接字符串的场景，Pydantic提供了灵活的配置方式。我们可以使用UrlConstraints和类型注解来覆盖默认的验证行为：

from pydantic import BaseModel, PostgresDsn, UrlConstraints
from typing import Annotated

class DatabaseConfig(BaseModel):
    dsn: Annotated[PostgresDsn, UrlConstraints(host_required=False)]

这种配置明确告诉Pydantic：对于PostgresDsn类型，不强制要求必须提供主机名。这样就能继续支持Unix域套接字连接方式，同时保持类型安全验证的其他优势。

最佳实践建议

1. 明确连接需求：如果确定只使用TCP/IP连接，保持默认验证即可；如果需要支持本地套接字连接，则使用上述解决方案。

2. 版本兼容性处理：在升级到Pydantic 2.10+时，检查项目中所有PostgreSQL连接字符串的使用情况，特别是开发环境配置。

3. 文档说明：在项目文档中明确记录数据库连接字符串的格式要求，避免团队成员混淆。

4. 环境区分：可以考虑为不同环境(开发/生产)使用不同的连接字符串验证规则，开发环境允许无主机名，生产环境则要求完整URL。

这一变化体现了Pydantic在灵活性和严格性之间的平衡，开发者需要根据实际需求选择合适的验证策略。