如何为WPGraphQL的自定义文章类型添加嵌套/多查询功能

核心逻辑说明 #

WPGraphQL通过register_graphql_connection方法建立不同数据类型之间的关联，你只需要在WordPress侧注册电影和演员两类CPT的双向连接即可实现嵌套查询。

前置检查 #

确认你注册电影、演员自定义文章类型时，已经添加了WPGraphQL支持参数：

• show_in_graphql 设置为 true
• 配置了graphql_single_name（单条数据的graphql类型名，比如电影设为Movie、演员设为Actor）
• 配置了graphql_plural_name（列表数据的graphql类型名，比如电影设为movies、演员设为actors）

步骤1：添加连接注册代码 #

将以下代码添加到你当前使用主题的functions.php文件，或者自定义功能插件的入口文件中：

add_action( 'graphql_register_types', function() {
    // 注册【电影→演员】的关联连接
    register_graphql_connection( [
        'fromType' => 'Movie', // 替换为你电影CPT的graphql_single_name
        'toType' => 'Actor', // 替换为你演员CPT的graphql_single_name
        'fromFieldName' => 'actors', // 查询时调用的关联字段名
        'resolve' => function( $movie, $args, $context, $info ) {
            // 替换为你存储演员ID列表的电影元字段键名
            $actor_ids = get_post_meta( $movie->databaseId, 'your_actor_meta_key', true );
            if ( empty( $actor_ids ) ) return null;
            // 若ID为字符串格式，转成整数数组
            $actor_ids = array_map( 'intval', (array)$actor_ids );

            // 调用WPGraphQL内置解析器返回关联演员数据
            $resolver = new \WPGraphQL\Data\Connection\PostObjectConnectionResolver( $context, $info );
            $resolver->set_query_arg( 'post_type', 'actor' ); // 替换为你演员CPT的slug
            $resolver->set_query_arg( 'post__in', $actor_ids );
            $resolver->set_query_arg( 'posts_per_page', -1 );
            return $resolver->get_connection();
        }
    ] );

    // 注册【演员→电影】的关联连接
    register_graphql_connection( [
        'fromType' => 'Actor', // 替换为你演员CPT的graphql_single_name
        'toType' => 'Movie', // 替换为你电影CPT的graphql_single_name
        'fromFieldName' => 'movies', // 查询时调用的关联字段名
        'resolve' => function( $actor, $args, $context, $info ) {
            // 替换为你存储电影ID列表的演员元字段键名
            $movie_ids = get_post_meta( $actor->databaseId, 'your_movie_meta_key', true );
            if ( empty( $movie_ids ) ) return null;
            $movie_ids = array_map( 'intval', (array)$movie_ids );

            $resolver = new \WPGraphQL\Data\Connection\PostObjectConnectionResolver( $context, $info );
            $resolver->set_query_arg( 'post_type', 'movie' ); // 替换为你电影CPT的slug
            $resolver->set_query_arg( 'post__in', $movie_ids );
            $resolver->set_query_arg( 'posts_per_page', -1 );
            return $resolver->get_connection();
        }
    ] );
} );

步骤2：调整GraphQL查询语句 #

WPGraphQL的连接遵循Relay规范，关联数据需要通过edges.node结构获取，最终可用的查询格式如下：

query GetMoviesWithActors {
  movies {
    edges {
      node {
        id
        title
        # 其他你需要的电影自定义字段
        actors {
          edges {
            node {
              id
              name
              # 其他你需要的演员自定义字段
            }
          }
        }
      }
    }
  }
}

查询演员关联电影的逻辑完全一致，将外层字段换成actors，关联字段换成movies即可。 #

注意事项 #

• 所有代码中的占位符需要替换为你自己项目的实际配置，否则会出现查询报错
• 如果你使用ACF创建自定义字段，可以用get_field()方法替代get_post_meta()获取字段值，逻辑完全一致
• 可以先在WordPress后台的WPGraphQL内置IDE中测试查询，确认数据返回正常后再对接Next.js前端

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