使用Npgsql向PostgreSQL 15发送超长INSERT查询报错求助

错误本质 #

你遇到的54000错误不是Npgsql对查询长度的限制，而是PostgreSQL的行大小限制。PostgreSQL默认主行的最大可用长度约8160字节（总行大小8192字节减去系统开销），当你插入的行所有非TOAST字段的总长度超过这个值时，就会触发该报错。

你尝试的Write Buffer Size是调整Npgsql的网络传输缓冲区，和数据库的行大小限制完全无关；给SQL加换行也不会改变行的实际字节长度，所以这两种方法都没用。

可行解决方案 #

1. 使用参数化查询（首选） #

参数化查询既能规避SQL注入风险，还能让PostgreSQL自动处理大字段的存储（通过TOAST机制将超长字段内容存到独立的TOAST表，不占用主行空间），彻底绕开主行大小限制。

示例代码：

string connectionString = "Host=--:5432;Username=postgres;Password=--;Database=-_-;";
var dataSource = NpgsqlDataSource.Create(connectionString);

// 请根据实际列名调整占位符顺序
var query = "INSERT INTO \"dsf_thdy_process\" VALUES (@commentaire, @text1, @text2, ..., @textN)";

using (var connection = dataSource.OpenConnection())
using (var command = dataSource.CreateCommand(query))
{
    // 逐个添加参数，对应表中每一列
    command.Parameters.AddWithValue("@commentaire", "Commentaire");
    command.Parameters.AddWithValue("@text1", "long_text");
    command.Parameters.AddWithValue("@text2", "long_text");
    // ... 继续添加所有字段对应的参数
    command.Parameters.AddWithValue("@textN", "long_text");

    command.ExecuteNonQuery();
}

2. 调整表字段类型 #

如果你的表中存储大文本的字段用了varchar(n)（n值较小）或char(n)这类固定/有限长度类型，改成text类型（PostgreSQL原生支持TOAST的类型），这样超长内容会被自动存到TOAST表，不占用主行空间。

修改字段类型的SQL：

ALTER TABLE "dsf_thdy_process" ALTER COLUMN 目标字段名 TYPE text;

3. 使用COPY命令批量插入（适合大量数据场景） #

如果需要批量插入大量超长数据，用PostgreSQL的COPY命令效率远高于普通INSERT，Npgsql也提供了对应的二进制导入API：

示例代码：

string connectionString = "Host=--:5432;Username=postgres;Password=--;Database=-_-;";
var dataSource = NpgsqlDataSource.Create(connectionString);

using (var connection = dataSource.OpenConnection())
using (var writer = connection.BeginBinaryImport("COPY \"dsf_thdy_process\" FROM STDIN BINARY"))
{
    // 写入一行数据
    writer.StartRow();
    writer.Write("Commentaire");
    writer.Write("long_text");
    writer.Write("long_text");
    // ... 写入当前行的所有字段
    writer.Write("long_text");

    // 如果有多行，重复StartRow和Write操作
    // writer.StartRow();
    // writer.Write(...);

    writer.Complete();
}

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