WordPress 的 WP_Query 不支持直接通过 post_title 参数查询文章，需改用 get_page_by_title() 函数或结合 s（搜索）参数、posts_where 钩子等替代方案实现标题匹配。
wordpress 的 `wp_query` 不支持直接通过 `post_title` 参数查询文章，需改用 `get_page_by_title()` 函数或结合 `s`（搜索）参数、`posts_where` 钩子等替代方案实现标题匹配。
WP_Query 是 WordPress 最常用的内容检索类，但它原生不支持 post_title 作为查询参数——这正是你代码未生效的根本原因。查看官方文档可知，WP_Query 支持的参数如 post_type、post_status、posts_per_page 等均对应数据库字段或内置逻辑，但 post_title 并不在其合法参数列表中（WP_Query 官方参数参考）。因此，即使你在 $args 中添加 'post_title' => $_GET['post_title']，WordPress 也会自动忽略该键，导致生成的 SQL 中缺失 AND post_title = '...' 条件。
✅ 正确解决方案
方案一：使用 get_page_by_title()（精确匹配单篇文章）
适用于已知标题且预期返回唯一文章的场景（如根据标题获取用户资料页）：
$title = sanitize_text_field( $_GET['post_title'] ?? '' );
if ( ! empty( $title ) ) {
$post = get_page_by_title( $title, OBJECT, 'user' );
if ( $post && 'publish' === $post->post_status ) {
// 成功获取到已发布的 'user' 类型文章
echo '<h2>' . esc_html( $post->post_title ) . '</h2>';
echo '<div>' . apply_filters( 'the_content', $post->post_content ) . '</div>';
} else {
echo '<p>未找到匹配的已发布文章。</p>';
}
}
⚠️ 注意：get_page_by_title() 默认只查 page 类型，需显式传入第三个参数指定 post_type（如 'user'），且不区分大小写，但不支持模糊匹配或多个结果。
方案二：使用搜索参数 s（简单模糊匹配）
若需类似“包含关键词”的效果，可利用内置搜索功能（需确保 post_type 支持搜索）：
$args = array(
'post_type' => 'user',
'posts_per_page' => -1,
'post_status' => 'publish',
's' => sanitize_text_field( $_GET['post_title'] ?? '' ), // 触发全文搜索
);
$query = new WP_Query( $args );
✅ 优点：无需钩子，开箱即用；
❌ 缺点：依赖 post_title 和 post_content 共同匹配，精度较低，且需确保该 post_type 在注册时启用了 'search' 支持（'supports' => ['title', 'editor', 'excerpt', 'author', 'thumbnail', 'comments', 'revisions', 'custom-fields', 'search']）。
方案三：使用 posts_where 钩子（高级定制，精确匹配）
如需完全控制 SQL 中的 WHERE 条件（例如严格匹配 post_title），可临时挂载过滤器：
function filter_query_by_title( $where, $wp_query ) {
global $wpdb;
$title = $wp_query->get( 'custom_post_title' );
if ( ! empty( $title ) ) {
$title = $wpdb->esc_like( $title );
$where .= $wpdb->prepare( " AND {$wpdb->posts}.post_title = %s", $title );
}
return $where;
}
// 设置自定义参数并挂载钩子
$custom_title = sanitize_text_field( $_GET['post_title'] ?? '' );
$args = array(
'post_type' => 'user',
'posts_per_page' => -1,
'post_status' => 'publish',
'custom_post_title' => $custom_title, // 自定义键，避免冲突
);
add_filter( 'posts_where', 'filter_query_by_title', 10, 2 );
$query = new WP_Query( $args );
remove_filter( 'posts_where', 'filter_query_by_title', 10 );
// 使用 $query 获取结果...
? 关键注意事项
- 永远校验和转义用户输入：使用 sanitize_text_field() 处理 $_GET 数据，防止 XSS 或 SQL 注入风险；
- 性能考量：get_page_by_title() 内部执行 SELECT ... WHERE post_title = ...，效率高；而 s 参数会触发全文索引或 LIKE 查询，大数据量下可能较慢；
- 自定义 post_type 必须注册正确：确保 'user' 类型已在 register_post_type() 中启用，并设置 'public' => true 及 'exclude_from_search' => false（若需搜索支持）；
- 调试技巧：可通过 echo $query->request; 查看最终 SQL，或使用 Query Monitor 插件深入分析查询性能。
综上，不要尝试向 WP_Query 直接传入 post_title——选择 get_page_by_title()（单条精确）、s 参数（简易模糊）或 posts_where 钩子（完全可控）才是符合 WordPress 架构的最佳实践。
