Pervasive SQL执行INSERT报无详情Syntax Error的调试方法咨询

问题现象 #

对接Pervasive SQL（简称PSQL）数据库执行插入操作时，驱动抛出通用语法错误，错误堆栈未提供具体错误原因、错误点位，仅返回通用提示：

Pervasive.Data.SqlClient.Lna.k: [LNA][PSQL][SQL Engine]Syntax Error.
   at Pervasive.Data.SqlClient.Lna.w.a(String , ad , l )
   at Pervasive.Data.SqlClient.PsqlCommand.a(Boolean , CommandBehavior , Boolean )
   at Pervasive.Data.SqlClient.PsqlCommand.ExecuteNonQuery()

关联执行信息 #

业务C#代码 #

using (PsqlCommand command = new PsqlCommand(sql, psqlConnection))
{
  command.Parameters.Clear();
  command.CommandText = sql;
  command.Parameters.AddWithValue("@KidDate", companyKIDDate);
  command.Parameters.AddWithValue("@KidTime", companyKIDTime);
  command.Parameters.AddWithValue("@KidMult", companyKIDMult);
  command.Parameters.AddWithValue("@KidComm", companyKIDComm);
  command.Parameters.AddWithValue("@DateGmt", companyKIDDate);
  command.Parameters.AddWithValue("@TimeGmt", companyKIDTime);
  command.Parameters.AddWithValue("@Seconds", companyKIDTime);  
  result = command.ExecuteNonQuery();
}

待执行SQL语句 #

INSERT INTO "FMUPDATE"
                        ("KID - date", "KID - time", "KID - user", "KID - mult", "KID - comm",
                        "Date GMT", "Time GMT",
                        "Flag",
                        "Pax Update",
                        "User ID",
                        "Count",
                        "Seconds",
                        "RockstarFlag")
                        VALUES(?, ?, 'RF01', ?, ?,
                        ?, ?,
                        1, 
                        1,
                        'RF01',
                        1,
                        ?,
                        1);

PsqlTrace追踪日志 #

00000001 09:21:53.704 T1 I43089283 Command::ExecuteNonQuery ENTER

    CommandText:      INSERT INTO "FMUPDATE"
                        ("KID - date", "KID - time", "KID - user", "KID - mult", "KID - comm",
                        "Date GMT", "Time GMT",
                        "Flag",
                        "Pax Update",
                        "User ID",
                        "Count",
                        "Seconds",
                        "RockstarFlag")
                        VALUES(?, ?, 'RF01', ?, ?,
                        ?, ?,
                        1, 
                        1,
                        'RF01',
                        1,
                        ?,
                        1);
    CommandType:      Text
    CommandTimeout:   30
    UpdatedRowSource: Both
    Par #1: @KidDate, Input, String, 0, System.Int32, 44755
    Par #2: @KidTime, Input, String, 0, System.Int32, 982
    Par #3: @KidMult, Input, String, 0, System.Int32, 128
    Par #4: @KidComm, Input, String, 0, System.Int32, 1
    Par #5: @DateGmt, Input, String, 0, System.Int32, 44755
    Par #6: @TimeGmt, Input, String, 0, System.Int32, 982
    Par #7: @Seconds, Input, String, 0, System.Int32, 982

    Error or Warning Received from Pervasive Server
    Number    = 0
    Message   = Pervasive.Data.SqlClient.Lna.k: [LNA][PSQL][SQL Engine]Syntax Error.
    Error Position = 37000

00000001 09:21:53.751 T1 I43089283 Command::ExecuteNonQuery EXIT
    Return: 0

排查定位步骤 #

• 先核对占位符与入参数量：数SQL语句VALUES子句里的?占位符共7个，代码中添加的参数总数也是7个，数量匹配，排除占位符多写漏写问题。
• 检查参数类型映射：从PsqlTrace日志可以看到，所有实际类型为System.Int32的入参，都被AddWithValue方法默认映射为数据库String类型。Pervasive SQL驱动遇到参数类型与目标字段类型不匹配时，不会抛出明确的类型转换错误，只会返回通用语法错误，这是本次报错的核心诱因。另外日志中返回的Error Position = 37000是驱动内部错误码，不是SQL文本的字符偏移位置，不要按这个数值去SQL中定位错误点位。
• 校验特殊字段名写法：PSQL要求带空格、特殊字符的字段名必须用双引号包裹，当前SQL中所有带空格的字段都已正确添加双引号，字段名写法符合语法规范。
• 若以上检查无异常，开启PSQL服务端全量执行日志，获取参数替换完成后的最终SQL文本，直接在PSQL自带的查询管理工具中执行，工具会返回更精准的错误点位。
• 额外注意：PSQL的ADO.NET驱动对?占位符采用严格顺序匹配，不识别参数名绑定，必须保证参数添加顺序和VALUES中占位符的顺序完全对应，同时逐个核对每个位置的参数类型、长度与表结构定义一致，尽量不要用AddWithValue做自动类型映射，显式指定参数的数据库类型可以规避绝大多数这类无详情报错。

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