SQLC项目中PostgreSQL的inet类型映射问题解析

在SQLC项目使用过程中，开发者遇到了PostgreSQL的inet类型无法正确映射到Go语言netip.Addr类型的问题。本文将深入分析该问题的技术背景、原因及解决方案。

问题现象

当开发者在SQLC配置文件中尝试将PostgreSQL的inet类型映射为Go语言的netip.Addr类型时，发现生成的代码仍然使用了pqtype.Inet类型，而非预期的netip.Addr。

技术背景

PostgreSQL的inet类型用于存储IPv4或IPv6地址，而Go语言标准库中的net/netip包提供了Addr类型来处理IP地址。SQLC作为SQL到Go代码的生成器，理论上应该支持这种类型映射。

问题分析

通过问题描述可以看出，开发者尝试了两种配置方式：

1. 直接映射到netip.Addr类型
2. 尝试先映射到string类型作为中间方案

但两种方式都未能成功。关键原因在于：

• SQLC对PostgreSQL的inet类型有默认的类型映射处理
• 当字段可为空(nullable)时，需要显式声明nullable: true配置项
• netip.Addr可能不是SQLC默认支持的映射目标类型

解决方案

根据社区反馈，正确的配置方式应该是：

overrides:
  - db_type: "inet"
    go_type: "net/netip.Addr"
    nullable: true

但实际测试表明，即使这样配置，SQLC可能仍无法正确处理netip.Addr类型的映射。这可能是由于：

1. SQLC内部对inet类型有特殊处理逻辑
2. netip.Addr类型未被SQLC完全支持

替代方案

鉴于上述问题，开发者最终选择了更可靠的解决方案：

1. 将数据库中的IP字段定义为TEXT类型
2. 在应用层进行IP地址的解析和验证

这种方案虽然增加了少量应用层逻辑，但保证了类型系统的可靠性和兼容性。

最佳实践建议

对于需要在SQLC中处理IP地址的情况，建议：

1. 优先考虑使用TEXT类型存储IP地址
2. 在Go代码中使用net.ParseIP或netip.ParseAddr进行解析
3. 如需数据库层验证，可使用PostgreSQL的CHECK约束
4. 关注SQLC的版本更新，未来可能会完善对netip包的支持

通过本文的分析，开发者可以更好地理解SQLC类型映射的机制，并在实际项目中做出更合理的技术选择。