FreeSQL 在 PostgreSQL 数组类型映射中的问题解析

问题背景

在使用 FreeSQL 进行数据库优先开发时，当 PostgreSQL 数据库中存在数组类型的字段时，代码生成器会生成不准确的 DbType 属性。具体表现为：对于 PostgreSQL 中的 int 数组类型字段（维度为1），生成的 C# 代码中 DbType 被错误地标记为 "int"，而实际上应该是 "int[]" 或者不生成 DbType 属性。

问题表现

在 PostgreSQL 14.6 数据库中定义了一个 int 数组类型的字段后，通过 FreeSQL 的 DbFirst 功能生成的实体类如下：

/// <summary>
/// 类型
/// </summary>
[JsonProperty, Column(Name = "type", DbType = "int")]
public int[] Type { get; set; }

这里的问题在于 DbType = "int" 与实际 C# 属性类型 int[] 不匹配，正确的应该是 DbType = "int[]" 或者完全不生成 DbType 属性。

技术分析

PostgreSQL 支持丰富的数组类型，这是其区别于其他关系型数据库的一个重要特性。在 PostgreSQL 中，任何基础类型都可以通过添加 [] 后缀来创建对应的数组类型。例如：

• integer → integer[]
• text → text[]
• boolean → boolean[]

FreeSQL 作为一款 ORM 框架，理论上应该能够正确处理这些数组类型的映射。从生成的代码来看，C# 端的属性类型 int[] 是正确的，但 DbType 的生成存在问题。

解决方案

目前官方给出的临时解决方案是手动修改模板后重新生成代码。对于需要立即使用的开发者，可以采取以下步骤：

1. 找到 FreeSQL 的代码生成模板
2. 修改模板中处理 PostgreSQL 数组类型的逻辑
3. 重新运行 DbFirst 生成代码

最佳实践建议

对于使用 PostgreSQL 数组类型的项目，建议：

1. 明确数组维度的定义，PostgreSQL 支持多维数组
2. 考虑是否真的需要使用数据库数组类型，有时关联表可能是更好的选择
3. 对于必须使用数组类型的场景，可以等待 FreeSQL 官方修复或按照上述方案临时处理

总结

FreeSQL 在处理 PostgreSQL 数组类型时存在 DbType 生成不准确的问题，虽然不影响基本功能，但可能导致一些高级场景下的困惑。开发者可以关注 FreeSQL 的更新，期待官方在未来版本中完善对 PostgreSQL 数组类型的支持。