WordPress 的 WP_Query 不支持直接通过 post_title 参数查询文章，需改用 get_page_by_title() 函数或结合 s（搜索）参数、posts_where 过滤器等替代方案实现标题匹配。
wordpress 的 `wp_query` 不支持直接通过 `post_title` 参数查询文章，需改用 `get_page_by_title()` 函数或结合 `s`（搜索）参数、`posts_where` 过滤器等替代方案实现标题匹配。
在 WordPress 开发中，初学者常误以为 WP_Query 支持 post_title 作为查询参数（如 'post_title' => 'Lisa I'），但事实上，该参数未被 WP_Query 官方识别，因此不会生成对应 SQL 条件，也不会影响最终查询结果——正如你所见，$query->request 中完全缺失 post_title = '...' 的 WHERE 子句。
✅ 正确的解决方案
方案一：使用 get_page_by_title()（适用于精确匹配单篇文章）
若你仅需根据完整、精确的标题获取一篇已发布文章（且类型为 page 或自定义 post type），推荐使用：
$title = sanitize_text_field($_GET['post_title'] ?? '');
$post = get_page_by_title($title, OBJECT, 'user'); // 第三个参数指定 post_type
if ($post && 'publish' === $post->post_status) {
echo esc_html($post->post_title);
// 可继续使用 $post->ID 等属性
} else {
echo '未找到匹配的文章';
}
⚠️ 注意：get_page_by_title() 默认只查找 page 类型；查询自定义类型（如 'user'）必须显式传入第三个参数 post_type，且该函数不区分大小写，但要求标题完全一致（含空格、标点）。
方案二：使用搜索参数 s（模糊/全文匹配）
若需模糊匹配或支持多结果，可借助内置搜索功能：
$args = array(
'post_type' => 'user',
'posts_per_page' => -1,
'post_status' => 'publish',
's' => sanitize_text_field($_GET['post_title'] ?? ''), // 触发 title + content 搜索
'fields' => 'ids', // 如只需 ID，可提升性能
);
$query = new WP_Query($args);
✅ 优点：原生支持、无需钩子；
❌ 缺点：会同时匹配标题和内容，且无法严格限定仅查标题。
方案三：使用 posts_where 过滤器（高级定制，精确控制 SQL）
若必须在 WP_Query 中实现 post_title = '...' 的精确 WHERE 条件，可通过过滤器手动注入：
function filter_query_by_title($where, $wp_query) {
global $wpdb;
$title = $wp_query->get('post_title');
if ($title) {
$title = $wpdb->esc_like($title);
$where .= $wpdb->prepare(" AND {$wpdb->posts}.post_title = %s", $title);
}
return $where;
}
add_filter('posts_where', 'filter_query_by_title', 10, 2);
// 执行查询（注意：需在 add_filter 后调用）
$args = array(
'post_type' => 'user',
'posts_per_page' => -1,
'post_status' => 'publish',
'post_title' => sanitize_text_field($_GET['post_title'] ?? ''),
);
$query = new WP_Query($args);
// 查询完成后移除过滤器，避免影响其他查询
remove_filter('posts_where', 'filter_query_by_title', 10);
✅ 优势：完全可控、精准匹配；
⚠️ 风险：需手动处理 SQL 安全（务必使用 $wpdb->prepare）、注意全局过滤器污染，建议封装为临时作用域逻辑。
? 总结与最佳实践
- ❌ 不要尝试在 WP_Query 中直接使用 'post_title' => ... —— 它无效；
- ✅ 单条精确匹配 → 优先用 get_page_by_title($title, OBJECT, $post_type)；
- ✅ 多条模糊匹配 → 使用 's' => $title 并配合 'post_type' 和 'post_status'；
- ✅ 高级定制需求 → 谨慎使用 posts_where + $wpdb->prepare，并及时移除钩子；
- ? 始终对用户输入（如 $_GET['post_title']）执行 sanitize_text_field() 或 esc_sql() 等安全处理，防止 SQL 注入。
通过合理选择上述任一方式，即可准确、安全地按标题检索 WordPress 文章数据。
