MySQL用户函数出现"Incorrect string value"错误，Steam ID转换函数求助

我之前帮不少开发者排查过类似的Steam ID转换问题，这个错误大概率和字符集不兼容或者转换逻辑生成了无效字符有关，咱们一步步拆解解决：

1. 先排查字符集适配问题 #

这个错误最常见的诱因是函数返回的字符串包含了当前数据库/表字符集不支持的内容。Steam ID转换后通常是STEAM_0:1:123456这类纯ASCII字符，但如果你的数据库字符集不是utf8mb4或utf8，或者函数返回类型没指定正确字符集，就容易踩坑：

• 先检查当前数据库的字符集配置：

  SELECT @@character_set_database, @@collation_database;
  

• 如果字符集不是utf8mb4，建议修改数据库和关联表的字符集：

  ALTER DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

• 同时确保函数返回类型明确指定字符集，比如：

  CREATE FUNCTION steam_id_to_string(steam_id BIGINT) 
  RETURNS VARCHAR(50) CHARACTER SET utf8mb4
  BEGIN
    -- 你的转换逻辑
  END;
  

2. 替换为可靠的Steam ID转换逻辑 #

老旧的函数可能没适配Steam ID的格式更新（比如64位ID的处理），导致生成了异常字符串。推荐替换成经过验证的转换逻辑，覆盖传统小ID和现代64位ID：

CREATE FUNCTION steam_id_to_string(steam_id BIGINT) 
RETURNS VARCHAR(50) CHARACTER SET utf8mb4
DETERMINISTIC
BEGIN
    DECLARE steam_id_base BIGINT DEFAULT 76561197960265728;
    DECLARE temp BIGINT;
    DECLARE auth_server TINYINT;
    DECLARE account_id BIGINT;
    
    -- 处理传统小数字Steam ID
    IF steam_id < steam_id_base THEN
        RETURN CONCAT('STEAM_0:', steam_id % 2, ':', FLOOR(steam_id / 2));
    -- 处理64位Steam ID
    ELSE
        SET temp = steam_id - steam_id_base;
        SET auth_server = temp % 2;
        SET account_id = FLOOR(temp / 2);
        RETURN CONCAT('STEAM_0:', auth_server, ':', account_id);
    END IF;
END;

3. 测试函数的输入输出 #

调用函数测试不同类型的Steam ID，验证是否还会触发错误：

SELECT steam_id_to_string(76561198083475328); -- 预期返回STEAM_0:0:61603750
SELECT steam_id_to_string(123456); -- 测试传统小ID

如果某个特定输入触发错误，那大概率是该输入的转换逻辑有问题，可以针对性调整判断条件。

4. 检查函数的字符集一致性 #

有时候函数本身的字符集和数据库默认字符集不一致，也会导致字符串值错误。创建函数时明确指定CHARACTER SET utf8mb4，能避免这类隐性兼容问题。

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