Audit.NET 中 PostgreSQL 数据列重复指定问题的解决方案

问题背景

在使用 Audit.NET 的 PostgreSQL 数据提供程序时，开发者可能会遇到"column 'data' specified more than once"的错误提示。这种情况通常发生在同时配置了默认数据列和自定义数据列的情况下。

问题分析

Audit.NET 的 PostgreSQL 数据提供程序默认会使用名为"data"的列来存储审计事件的 JSON 表示。当开发者在配置中同时显式指定了名为"data"的自定义列时，就会导致列名重复的问题。

解决方案

针对这个问题，我们有以下三种解决方案：

方案一：显式禁用默认数据列

Audit.Core.Configuration.Setup()
    .UsePostgreSql(config => config
        .ConnectionString("connectionString")
        .Schema("videogame")
        .TableName("auditevent")
        .IdColumnName("id")
        .DataColumn((string)null)   // 显式禁用默认数据列
        .CustomColumn("data", ev => ev.ToJson())
        .LastUpdatedColumnName("last_updated")
        .CustomColumn("event_type", ev => ev.EventType)
        .CustomColumn("timestamp", ev => ev.StartDate));

这种方法保留了自定义的"data"列配置，同时通过设置.DataColumn((string)null)显式禁用了默认的数据列。

方案二：使用默认数据列配置

Audit.Core.Configuration.Setup()
    .UsePostgreSql(config => config
        .ConnectionString("connectionString")
        .Schema("videogame")
        .TableName("auditevent")
        .IdColumnName("id")
        .LastUpdatedColumnName("last_updated")
        .CustomColumn("event_type", ev => ev.EventType)
        .CustomColumn("timestamp", ev => ev.StartDate));

这种方法最简单，直接移除自定义的"data"列配置，完全依赖 Audit.NET 的默认行为，将审计事件存储在默认的"data"列中。

方案三：显式配置数据列类型和值

Audit.Core.Configuration.Setup()
    .UsePostgreSql(config => config
        .ConnectionString("connectionString")
        .Schema("videogame")
        .TableName("auditevent")
        .IdColumnName("id")
        .DataColumn("data", DataType.JSON, ev => ev.ToJson())   // 显式配置数据列
        .LastUpdatedColumnName("last_updated")
        .CustomColumn("event_type", ev => ev.EventType)
        .CustomColumn("timestamp", ev => ev.StartDate));

这种方法提供了最大的灵活性，可以显式指定数据列的名称、数据类型和值生成方式。

最佳实践建议

1. 一致性原则：在整个项目中保持一致的配置方式，避免混合使用不同方案
2. 明确性优先：推荐使用方案三，因为它最明确地表达了开发者的意图
3. 文档记录：无论采用哪种方案，都应在项目文档中记录配置选择及其原因
4. 测试验证：配置变更后，务必进行充分的测试验证数据存储的正确性

总结

Audit.NET 的 PostgreSQL 数据提供程序提供了灵活的配置选项，开发者需要理解默认行为和显式配置之间的关系。通过本文介绍的三种解决方案，开发者可以根据项目需求选择最适合的配置方式，避免列名重复的问题，确保审计数据能够正确存储。