WordPress主题开发：自定义SQL函数SPLIT_STR线上环境失效求助

首先，咱们来拆解下你遇到的问题：本地环境中按姓氏首字母匹配诗人的SQL查询正常工作，但线上环境失效，而且单独测试函数、在phpMyAdmin中跑查询都没问题——这种情况大概率是环境差异或者WordPress查询预处理的细节问题导致的，下面一步步分析解决：

一、先排查预处理后的实际SQL语句 #

WordPress的$wpdb->prepare会对参数进行转义，但有时候可能因为环境差异导致生成的SQL和你预期的不一样。你可以在代码中临时输出实际执行的SQL，对比线上和本地的差异：

// 生成预处理后的SQL
$sql = $wpdb->prepare(
    "SELECT ID FROM $wpdb->posts WHERE SUBSTR(SPLIT_STR($wpdb->posts.post_title, ' ', 2), 1, 1) = %s ORDER BY $wpdb->posts.post_title",
    $letter
);
// 输出到错误日志（线上环境推荐），或者临时echo（测试用）
error_log('执行的SQL：' . $sql);
// 然后执行查询
$postids = $wpdb->get_col($sql);

把线上生成的SQL复制到phpMyAdmin中执行，如果能正常返回结果，说明问题出在WordPress的查询执行环节；如果也不行，那就是SQL语句本身在不同环境下的兼容性问题。

二、排查字符集与排序规则差异 #

本地和线上数据库的字符集/排序规则不一致是这类问题的常见诱因：比如本地用utf8_general_ci，线上用utf8mb4_unicode_ci，可能导致首字母的匹配逻辑出现偏差（比如大小写、特殊字符的处理）。

你可以修改查询，强制指定统一的排序规则，比如：

$postids = $wpdb->get_col($wpdb->prepare(
    "SELECT ID FROM $wpdb->posts 
     WHERE SUBSTR(SPLIT_STR($wpdb->posts.post_title, ' ', 2), 1, 1) COLLATE utf8mb4_unicode_ci = %s COLLATE utf8mb4_unicode_ci
     ORDER BY SPLIT_STR($wpdb->posts.post_title, ' ', 2) ASC",
    $letter
));

注意：这里的utf8mb4_unicode_ci要换成你线上数据库实际使用的排序规则（可以在phpMyAdmin中查看posts表的字符集设置）。

三、优化姓氏提取逻辑（顺便解决排序需求） #

你当前用SPLIT_STR(post_title, ' ', 2)提取姓氏有个隐患：如果诗人名字包含多个空格（比如“Mary Ann Evans”），会错误提取第二个词作为姓氏。更可靠的方式是取名字的最后一个词作为姓氏，用MySQL原生的SUBSTRING_INDEX代替自定义函数：

$postids = $wpdb->get_col($wpdb->prepare(
    "SELECT ID FROM $wpdb->posts 
     WHERE SUBSTR(SUBSTRING_INDEX($wpdb->posts.post_title, ' ', -1), 1, 1) COLLATE utf8mb4_unicode_ci = %s COLLATE utf8mb4_unicode_ci
     ORDER BY SUBSTRING_INDEX($wpdb->posts.post_title, ' ', -1) ASC",
    $letter
));

SUBSTRING_INDEX(post_title, ' ', -1)会自动取最后一个空格后的内容，不管名字有多少个部分，比如“Leonardo da Vinci”会正确提取“Vinci”作为姓氏。而且这个函数是MySQL原生函数，不需要依赖自定义的SPLIT_STR，兼容性更好！

四、其他可能的排查点 #

• 检查自定义函数的存在性：虽然你说单独执行函数没问题，但可以再确认线上数据库中SPLIT_STR函数是否存在，权限是否正确（比如函数的定义者和WordPress数据库用户是否一致）。
• MySQL版本差异：本地和线上的MySQL版本如果差距较大，可能对自定义函数的支持有细微差异。用原生的SUBSTRING_INDEX替代自定义函数可以规避这个问题。
• WordPress查询缓存：线上环境可能开启了查询缓存，你可以尝试添加$wpdb->flush()清空缓存后再执行查询。

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