如何从SQL Server错误号515的错误消息中提取列名并生成用户友好型错误描述用于日志记录

阿华AIGC实验室

2026-4-3

嗨，这个需求我在日常做数据库日志和用户友好错误提示时经常碰到，给你分享两种实际工作里验证过的靠谱方案，不管是在数据库层面用T-SQL处理，还是在应用层捕获错误后处理都能搞定：

一、T-SQL层面直接处理（适合在数据库的TRY/CATCH块中写入日志）

SQL Server错误号515的消息格式是固定的——列名必然被单引号包裹在Cannot insert the value NULL into column 'XXX'这段文本里，所以我们可以用字符串函数精准截取列名，再拼接成友好描述。

具体代码示例（结合TRY/CATCH）

-- 假设日志表结构：ErrorLog(ErrorLogID INT IDENTITY(1,1) PRIMARY KEY, ErrorDescription NVARCHAR(256))
BEGIN TRY
    -- 模拟触发515错误的插入操作（缺少NOT NULL的LastName列）
    INSERT INTO CustomerDB.dbo.CustomerTable (FirstName) VALUES ('张三');
END TRY
BEGIN CATCH
    -- 只处理错误号515的情况
    IF ERROR_NUMBER() = 515
    BEGIN
        DECLARE @RawErrorMessage NVARCHAR(4000) = ERROR_MESSAGE();
        DECLARE @TargetColumnName NVARCHAR(128);
        DECLARE @FriendlyError NVARCHAR(256);

        -- 提取被单引号包裹的列名：找第一个单引号和第二个单引号的位置，截取中间内容
        SET @TargetColumnName = SUBSTRING(
            @RawErrorMessage,
            CHARINDEX('''', @RawErrorMessage) + 1,
            CHARINDEX('''', @RawErrorMessage, CHARINDEX('''', @RawErrorMessage) + 1) - CHARINDEX('''', @RawErrorMessage) - 1
        );

        -- 生成用户友好的错误描述
        SET @FriendlyError = @TargetColumnName + ' is required';

        -- 写入日志表
        INSERT INTO ErrorLog (ErrorDescription) VALUES (@FriendlyError);
    END
    -- 其他错误可以根据需求另行处理
END CATCH

逻辑说明

利用CHARINDEX定位两个单引号的位置，再用SUBSTRING截取中间的列名——因为515错误的消息格式是微软标准化的，只要错误号没错，这个提取逻辑几乎不会失效。

二、应用层处理（比如C#/Java等业务代码中捕获错误）

如果是在应用程序里捕获SQL异常，用正则表达式匹配列名会更灵活，同样针对515错误的固定格式来写正则规则即可。

C#代码示例

using System.Data.SqlClient;
using System.Text.RegularExpressions;

try
{
    // 执行插入数据库的代码
    using (var conn = new SqlConnection("你的数据库连接字符串"))
    {
        conn.Open();
        var cmd = new SqlCommand("INSERT INTO CustomerDB.dbo.CustomerTable (FirstName) VALUES ('张三')", conn);
        cmd.ExecuteNonQuery();
    }
}
catch (SqlException ex)
{
    // 只处理错误号515的异常
    if (ex.Number == 515)
    {
        // 用正则匹配第一个被单引号包裹的内容（就是列名）
        var match = Regex.Match(ex.Message, @"'([^']+)'");
        if (match.Success)
        {
            string columnName = match.Groups[1].Value;
            string friendlyError = $"{columnName} is required";
            
            // 这里执行写入日志表的操作
            // 比如调用日志插入的方法：InsertIntoErrorLog(friendlyError);
        }
    }
}