升级Npgsql至8.0.1后写入复合类型数组参数出现缓冲错误

针对你升级Npgsql到8.0.1后遇到的随机缓冲区错误，结合错误栈和版本变更点，给出以下具体排查方向：

1. 同步/异步执行路径不匹配 #

错误栈中多次出现async参数，说明同步执行命令时可能触发了异步序列化逻辑。Npgsql 8.x重构了复合类型的序列化机制，同步和异步路径的缓冲区校验逻辑不同：

• 如果你用的是同步方法（如ExecuteNonQuery），确保所有复合类型的字段转换器都实现了同步Write方法，不要混用异步逻辑；
• 或者统一切换为异步调用链（ExecuteNonQueryAsync），避免同步/异步代码交叉导致的缓冲区状态异常。

2. 复合类型参数的精确配置 #

即使改用了泛型NpgsqlParameter<T>，仍需注意以下细节：

• 必须显式指定Typename为PostgreSQL复合类型的完整名称（如public.my_custom_type），不能依赖自动推断；
• 参数的NpgsqlDbType要设为Array | NpgsqlDbType.Composite，示例代码：

  var param = new NpgsqlParameter<List<MyComposite>>("p_items", NpgsqlDbType.Array | NpgsqlDbType.Composite)
  {
      Typename = "public.my_custom_type",
      Value = itemsList
  };
  

• 检查复合类型的CLR映射类与PostgreSQL定义完全一致，字段顺序、类型无偏差。

3. 连接池与线程安全排查 #

随机报错大概率和共享资源的线程安全有关：

• 禁止在多个线程间复用NpgsqlCommand或NpgsqlParameter实例，每个数据库操作都要创建新的命令和参数对象；
• 临时在连接字符串中添加Pooling=false禁用连接池，如果问题消失，说明是连接池内的连接状态被污染，需检查是否有未正确释放的命令/事务。

4. 缓冲区配置调整（针对边界情况） #

虽然小数据也报错，但Npgsql 8.x的缓冲区分配逻辑可能存在边界问题：

• 尝试增大WriteBufferSize（比如设为WriteBufferSize=65536），同时禁用自动准备语句（MaxAutoPrepare=0），避免缓存的语句参数缓冲区不匹配；
• 小数据报错可能是复合类型中包含可变长度字段（如字符串），序列化时动态扩展缓冲区出现竞态，调整缓冲区大小可以缓解这类问题。

5. 临时兼容写法验证 #

如果以上方法都无效，可临时用Npgsql 7.x兼容的写法绕开：

• 手动将复合类型数组序列化为PostgreSQL文本格式（例如把每个复合对象转成(val1,val2)格式，再用逗号拼接成字符串），作为text类型参数传入存储过程；
• 在存储过程内部用unnest(string_to_array(@p_items, ','))转换为复合类型数组执行逻辑。如果这种写法不报错，说明是Npgsql 8.x的复合类型数组序列化存在bug，建议提交官方issue。

内容的提问来源于stack exchange，提问作者Linda