WordPress中post_per_page设为50后页面渲染数量异常求助

Hey there! Let's figure out why your image gallery isn't displaying 50 posts per page as you configured. Here are the most common issues to check, step by step:

1. Verify Your Query Parameters #

First, double-check how you're setting up the query—small mistakes here are often the culprit:

• Use an integer for posts_per_page: You used '50' (a string), while WordPress expects an integer. While it might auto-convert, switching to 50 avoids potential edge-case issues.
• Target the right post type: If you're pulling images from the media library, you need to specify post_type => 'attachment' and post_status => 'inherit' (since media attachments use inherit status by default).
• Filter for image files: Add post_mime_type => 'image' to ensure you're only loading image attachments, not other file types.

Example of a corrected query:

$image_args = array(
    'post_type'      => 'attachment',
    'post_status'    => 'inherit',
    'posts_per_page' => 50, // Integer instead of string
    'post_mime_type' => 'image',
    'orderby'        => 'date',
    'order'          => 'DESC'
);
$image_query = new WP_Query( $image_args );

If you're using the pre_get_posts hook to modify the main query, make sure you only target your specific image page (to avoid breaking other parts of your site):

function adjust_image_page_post_count( $query ) {
    // Only affect the main query on your image page, not admin or other pages
    if ( !is_admin() && $query->is_main_query() && is_page( 'your-image-page-slug' ) ) {
        $query->set( 'posts_per_page', 50 );
        $query->set( 'post_type', 'attachment' );
        $query->set( 'post_status', 'inherit' );
        $query->set( 'post_mime_type', 'image' );
    }
}
add_action( 'pre_get_posts', 'adjust_image_page_post_count' );

2. Check for Theme or Hardcoded Limits #

Many themes hardcode post limits in template files. Look for:

• query_posts() calls in your page template (e.g., page-images.php) that override posts_per_page to 9.
• Theme customizer settings that control posts per page for gallery/image sections.

3. Confirm Available Image Posts #

It sounds obvious, but make sure you actually have 50 publicly accessible images in your media library:

• Check for images marked as "Draft", "Private", or in the trash—these won't show up in public queries.
• Use the media library filter to count how many published (inherit status) images you have. If you only have 9, that's exactly why you're seeing 9!

4. Rule Out Plugin or Hook Interference #

Other plugins or custom code might be modifying your query after you set it:

• Temporarily disable all plugins and switch to a default WordPress theme (like Twenty Twenty-Four). If the 50 images show up, re-enable plugins one by one to find the culprit.
• Check for other pre_get_posts or posts_clauses hooks in your functions.php file that might be overriding posts_per_page.

5. Clear Caching #

If you use a caching plugin (e.g., WP Rocket, W3 Total Cache) or server-side caching, your page might be serving an old cached version. Clear all caches and refresh the page to see if the correct count loads.

Start with these checks—most of the time, the issue is a simple parameter fix, theme/plugin conflict, or post status oversight. Let me know if you need help narrowing it down further!

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