为何MySQL UNION查询在WordPress的PHP代码中无法生效？

嘿，这种情况我在帮别人调试WordPress代码时碰到好多次了，大概率是没踩准UNION的核心规则，或者WordPress数据库调用的细节没注意到。咱们一步步拆解可能的问题：

1. 先确认UNION的基础语法规则（最常见坑） #

UNION和UNION ALL有个硬性要求：所有SELECT子句必须返回相同数量的列，且对应列的数据类型要兼容。比如第一个查了ID, title, created_at（整数、字符串、日期），第二个就不能只查ID, name（少一列），也不能把日期列换成整数列，不然MySQL直接拒绝执行。

你可以先把拼接好的完整SQL语句复制到phpMyAdmin或者Navicat里跑一遍，要是直接报错，那就是语法或列匹配的问题，和WordPress调用无关。

2. WordPress $wpdb调用的细节问题 #

（1）必须用$wpdb->prepare()处理SQL #

不要直接拼接字符串，一是有注入风险，二是特殊字符（比如引号、空格）会破坏SQL结构。正确的写法应该是：

global $wpdb;
$sql = $wpdb->prepare(
    "SELECT id, title FROM %s WHERE status = %d UNION ALL SELECT id, name FROM %s WHERE active = %d",
    $wpdb->prefix . 'table1', // 自定义表要加前缀！
    1,
    $wpdb->prefix . 'table2',
    1
);
$results = $wpdb->get_results($sql);

（2）别忘了表前缀 #

WordPress默认会给表加前缀（比如wp_），如果你直接写表名table1，WordPress会找不到这张表，自然返回空结果。一定要用$wpdb->prefix . '你的表名'来拼接正确的表名。

3. 排查错误的实用技巧 #

WordPress的$wpdb自带错误排查工具，执行完查询后可以直接看最后一次错误：

$results = $wpdb->get_results($sql);
if ($wpdb->last_error) {
    echo '数据库错误详情：' . $wpdb->last_error;
}

这个能直接告诉你MySQL到底哪里不爽，比如列数不匹配、表不存在、权限不够之类的，比瞎猜高效多了。

4. 容易忽略的语法小坑 #

• 每个SELECT子句后面不要加多余的分号，比如SELECT * FROM t1; UNION SELECT * FROM t2，分号会让MySQL把后面的UNION当成新语句，WordPress可能只执行第一个查询。
• 如果要加ORDER BY，必须放在整个UNION语句的最后，而且要用列的别名或者位置来排序。比如：

  SELECT ID, post_title as item_title FROM wp_posts 
  UNION ALL 
  SELECT id, item_name FROM wp_custom_items 
  ORDER BY item_title DESC
  

完整示例代码 #

给你一个能直接参考的正确写法：

global $wpdb;

// 定义带前缀的表名
$post_table = $wpdb->prefix . 'posts';
$custom_table = $wpdb->prefix . 'custom_products';

// 构建兼容的UNION ALL查询
$sql = $wpdb->prepare(
    "SELECT ID as item_id, post_title as item_name, post_date as create_time FROM %s WHERE post_status = %s
     UNION ALL
     SELECT id, product_name, create_at FROM %s WHERE is_published = %d",
    $post_table,
    'publish',
    $custom_table,
    1
);

// 执行查询并排查错误
$results = $wpdb->get_results($sql);
if ($wpdb->last_error) {
    var_dump($wpdb->last_error);
} else {
    // 处理返回结果
    foreach ($results as $item) {
        echo $item->item_id . ' - ' . $item->item_name . '<br>';
    }
}

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