.NET C#操作MySQL插入语句执行失败及参数差异问题求助

问题背景 #

在Repository类的Create()方法中尝试向MySQL数据库的documentdetails表（含自增字段Id和BigInt类型字段DocumentId）插入记录时，出现命令执行失败、连接超时、事务提交失败等错误。通过Postman传入documentID=1165078时可成功创建记录，但代码赋值documentId时触发错误；同时存在两种String.Format拼接SQL的执行结果差异。

原插入代码的核心错误分析 #

1. SQL语法严重错误
   原代码中的SQL语句INSERT INTO documentdetails (?dtoDocumentId);完全不符合MySQL的INSERT语法规范。正确的INSERT语句需要明确指定要插入的字段，并通过VALUES子句传入对应值，错误的语法直接导致SQL执行失败，引发后续一系列错误。

2. 潜在数据类型匹配问题（次要）
   虽然documentId是long类型（对应MySQL的BigInt），且参数指定了MySqlDbType.Int64，但如果documentDetail.DocumentId是可空类型（如long?），未处理空值的情况下会导致参数值异常，不过这是次要问题，语法错误才是首要诱因。

修复方案 #

修正SQL语法，同时保留安全的参数化查询（避免SQL注入），代码调整如下：

// 修正SQL语法，明确指定插入字段和VALUES子句
MySqlCommand command = new MySqlCommand("INSERT INTO `documentdetails` (`DocumentId`) VALUES (?dtoDocumentId);", _connection);
command.CommandType = CommandType.Text;

// 处理可空类型（如果DTO的DocumentId是long?）
if (!documentDetail.DocumentId.HasValue)
{
    throw new ArgumentNullException(nameof(documentDetail.DocumentId), "DocumentId不能为空");
}
// 显式转换为long，确保类型匹配
command.Parameters.Add("?dtoDocumentId", MySqlDbType.Int64).Value = (long)documentDetail.DocumentId;
command.ExecuteNonQuery();

说明：

• 移除冗余的command.Connection = _connection;，因为构造函数已传入连接对象
• 若DTO的DocumentId为非可空long类型，可省略空值判断，直接赋值即可

关于两种String.Format拼接SQL的差异解释 #

失败场景：String.Format(..., documentDetail.DocumentId) #

失败的核心原因是documentDetail.DocumentId的实际值不符合预期：

• 如果documentDetail.DocumentId是可空long类型（long?），当值为null时，String.Format会将其转换为空字符串，最终SQL变为VALUES ();，触发语法错误
• 如果DTO中DocumentId被错误定义为字符串类型，当字符串包含非数字字符、空格或格式异常时，会导致SQL语法错误或类型不匹配
• 隐式转换异常：若documentDetail.DocumentId是其他数值类型（如int）被包装为object，格式化后的输出可能不符合MySQL BigInt的解析要求

成功场景：String.Format(..., 1165078) #

直接传入整数常量1165078时，String.Format会生成语法正确的SQL语句VALUES (1165078);，数值类型与数据库的BigInt完全匹配，因此执行成功。

⚠️ 重要提醒：禁止使用String.Format拼接SQL语句，这种方式存在严重的SQL注入风险，参数化查询才是安全且规范的做法。

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