FreeSql中处理PostgreSQL自增列与On Conflict冲突的问题

在使用FreeSql操作PostgreSQL数据库时，开发者可能会遇到一个常见问题：当实体类中包含自增列(Identity)时，即使显式调用了IgnoreColumns方法或InsertColumns方法，在OnConflictDoUpdate操作中自增列仍然会被包含在INSERT语句中。

问题现象

考虑以下实体类定义：

[Table(Name = "CodeFirstEntity")]
public class CodeFirstEntity
{
    [Column(Name = "id", IsPrimary = true)]
    public long Id { get; set; }

    [Column(Name = "identity", IsIdentity = true, CanInsert = false)]
    public long Identity { get; set; }

    [Column(Name = "str_name", StringLength = 20, IsNullable = false)]
    public string str_name { get; set; } = string.Empty;
}

当尝试执行以下插入操作时：

var entity = new CodeFirstEntity
{
    Id = 1,
    str_name = "name"
};

var sql = fsql.Insert(entity)
         .IgnoreColumns(s => s.Identity)
         .NoneParameter()
         .OnConflictDoUpdate()
         .DoNothing()
         .ToSql();

生成的SQL语句会包含自增列：

INSERT INTO CodeFirstEntity(id, identity, str_name) VALUES(1, 0, 'name')
ON CONFLICT(id) DO NOTHING

而期望的SQL应该是：

INSERT INTO CodeFirstEntity(id, str_name) VALUES(1, 'name')
ON CONFLICT(id) DO NOTHING

问题原因

这个问题源于FreeSql对自增列的特殊处理机制。即使开发者显式调用了IgnoreColumns方法，FreeSql仍然会优先考虑自增列的属性设置(IsIdentity=true)。这种行为在大多数情况下是合理的，因为自增列通常不应该由开发者手动指定值。

解决方案

方案1：使用新实体类型

最推荐的解决方案是创建一个专门用于插入操作的DTO类，这个类不包含自增列属性：

public class CodeFirstEntityInsertDto
{
    public long Id { get; set; }
    public string str_name { get; set; } = string.Empty;
}

然后使用这个DTO进行插入操作：

var dto = new CodeFirstEntityInsertDto
{
    Id = 1,
    str_name = "name"
};

var sql = fsql.Insert(dto)
         .NoneParameter()
         .OnConflictDoUpdate()
         .DoNothing()
         .ToSql();

方案2：临时移除IsIdentity特性

如果必须使用原始实体类，可以在运行时临时修改特性：

var entity = new CodeFirstEntity
{
    Id = 1,
    str_name = "name"
};

var insert = fsql.Insert(entity);
var prop = typeof(CodeFirstEntity).GetProperty("Identity");
var columnAttr = prop.GetCustomAttribute<ColumnAttribute>();
columnAttr.IsIdentity = false; // 临时禁用

var sql = insert.IgnoreColumns(s => s.Identity)
         .NoneParameter()
         .OnConflictDoUpdate()
         .DoNothing()
         .ToSql();

columnAttr.IsIdentity = true; // 恢复

方案3：使用原生SQL

对于复杂场景，可以考虑直接使用原生SQL：

var sql = "INSERT INTO CodeFirstEntity(id, str_name) VALUES(@id, @name) ON CONFLICT(id) DO NOTHING";
fsql.Ado.ExecuteNonQuery(sql, new { id = 1, name = "name" });

最佳实践建议

1. 分离实体类型：为插入操作创建专门的DTO类型，避免直接使用包含自增列的实体类
2. 特性使用规范：谨慎使用IsIdentity特性，确保只在真正需要自增的列上使用
3. 代码审查：在团队开发中，建立代码审查机制，确保数据库操作符合预期
4. 单元测试：为关键数据库操作编写单元测试，验证生成的SQL是否符合预期

通过以上方法，开发者可以灵活处理FreeSql中自增列与PostgreSQL的ON CONFLICT语法之间的兼容性问题。