WordPress自定义operations表查询始终返回无结果问题求助

核心问题定位 #

代码始终返回无结果的根本原因是SQL语法存在多处错误，查询未正常执行，并非没有匹配数据：

• $wpdb->prepare() 调用逻辑完全错误：该方法要求使用%s（字符串类型）、%d（整数类型）作为占位符绑定参数，禁止直接将PHP变量拼接进SQL语句；同时你错误地将get_results的返回格式常量ARRAY_N写在了SQL语句内部，直接触发SQL语法错误。
• 逻辑运算符兼容性问题：MySQL中||在部分SQL模式下为字符串拼接符，不代表逻辑或判断，会导致查询条件失效，标准逻辑或判断应使用OR关键字。
• 结果集读取格式不匹配：ARRAY_N常量指定返回数字索引数组，无法通过$row['sku']这类关联键名取值，会导致读取数据失败。
• 缺少空值判断逻辑：如果用户仅填写SKU或仅填写条码，空字符串参与匹配会直接过滤掉所有有效结果。
• 未开启数据库错误提示，SQL执行失败后无法看到具体报错，只能触发无结果的返回分支。

修复后可直接使用的代码 #

后端select_user.php代码 #

<?php
// 加载WordPress核心文件
require( __DIR__ . '/../../../wp-load.php' );
global $wpdb;
// 调试阶段开启数据库报错，正式上线后注释该行
$wpdb->show_errors();

// 初始化参数，做非空兜底处理
$sku = isset($_POST['sku']) ? trim($_POST['sku']) : '';
$barcode = isset($_POST['barcode']) ? trim($_POST['barcode']) : '';

// 动态拼接查询条件，避免空值参与匹配
$whereClauses = [];
$prepareParams = [];
if (!empty($sku)) {
    $whereClauses[] = 'sku = %s';
    $prepareParams[] = $sku;
}
if (!empty($barcode)) {
    $whereClauses[] = 'barcode = %s';
    $prepareParams[] = $barcode;
}

// 未填写任何查询条件时直接返回提示
if (empty($whereClauses)) {
    echo '请输入SKU或条码后再执行搜索';
    exit;
}

// 组装SQL，表名用反引号包裹避免关键字冲突
$operationTable = $wpdb->prefix . 'operations';
$sql = "SELECT * FROM `{$operationTable}` WHERE " . implode(' OR ', $whereClauses);

// 正确调用prepare绑定参数，指定返回关联数组格式结果
$preparedSql = $wpdb->prepare($sql, $prepareParams);
$searchResults = $wpdb->get_results($preparedSql, ARRAY_A);

if (!empty($searchResults)) {
    foreach ($searchResults as $row) {
        // 输出所有匹配字段，输出时做转义避免XSS风险
        echo 'ID: ' . esc_html($row['id']) . '<br/>';
        echo '录入日期: ' . esc_html($row['date']) . '<br/>';
        echo '标题: ' . esc_html($row['title']) . '<br/>';
        echo '规格: ' . esc_html($row['size']) . '<br/>';
        echo 'SKU: ' . esc_html($row['sku']) . '<br/>';
        echo '条码: ' . esc_html($row['barcode']) . '<br/>';
        echo '价格: ' . esc_html($row['price']) . '<br/>';
        echo '<hr/>';
    }
} else {
    // 调试阶段可打印执行的SQL核对语句，正式上线后删除该行
    echo '无匹配结果，本次执行的SQL语句：' . esc_html($preparedSql);
}

前端表单优化建议（可选） #

在表单中加入WordPress安全校验字段，避免跨站请求伪造：

<form method="post" action="https://site-name.com/wp-content/themes/theme/select_user.php">
    <?php wp_nonce_field('operation_search', 'search_nonce'); ?>
    <label for="sku">SKU:</label><br/>
    <input type="text" name="sku" size="30"><br/>
    <label for="barcode">Barcode:</label><br/>
    <input type="text" name="barcode" size="30"><br/>
    <input id="submit" type="submit" value="Search"><br/>
</form>

后端接收参数时可在最开始加入校验逻辑：

if (!wp_verify_nonce($_POST['search_nonce'] ?? '', 'operation_search')) {
    echo '非法请求';
    exit;
}

额外排查步骤 #

如果替换代码后仍无法查到数据，按以下顺序核对：

• 确认数据库表名正确：登录数据库管理面板，确认自定义表的前缀和WordPress当前配置的表前缀一致，比如默认前缀为wp_时，表名应为wp_operations，不要出现拼写错误。
• 确认字段名完全匹配：核对表内字段的拼写、大小写，避免出现bar_code和barcode这类拼写偏差。
• 确认存储的数据无多余字符：如果数据入库时带有首尾空格、不可见字符，精确匹配会失败，可将等值匹配改为模糊匹配，例如将sku = %s改为sku LIKE %s，对应参数改为'%' . $sku . '%'。
• 不建议直接通过访问主题目录下PHP文件的方式实现功能，可将搜索逻辑挂载到WordPress的init钩子上，避免核心文件加载异常。

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