迁移WordPress站点至本地后子页面异常，无错误日志求助

Hey there! Let's break down why your subpages aren't loading after migrating your WordPress site locally—this is a super common hiccup, so we'll work through actionable checks step by step:

1. Fix Permalink Settings (Most Likely Culprit) #

WordPress relies on rewrite rules to handle pretty permalinks, and local servers often don't have this configured out of the box:

• First, log into your local WP admin, go to Settings > Permalinks, select any option except "Plain" (e.g., "Post name"), and click "Save Changes". This triggers WordPress to regenerate rewrite rules and update your .htaccess file.
• If that doesn't work:
  • For Apache: Ensure the mod_rewrite module is enabled (check your server's config, like in WAMP/MAMP's module manager). Then verify your .htaccess file in the WordPress root has these rules (if not, add them manually):

    # BEGIN WordPress
    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    RewriteRule ^index\.php$ - [L]
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . /index.php [L]
    </IfModule>
    # END WordPress
    

  • For Nginx: Add this rewrite rule to your server block configuration to redirect all requests to index.php:

    try_files $uri $uri/ /index.php?$args;
    

2. Verify Full URL Replacement in Database #

Manually replacing links might miss hidden URLs in options, custom fields, or plugin settings. Use WP-CLI for a thorough search-replace (if you have WP-CLI installed):

wp search-replace 'https://your-live-domain.com' 'http://your-local-domain.test' --all-tables

Make sure to replace the example URLs with your actual live and local domains. The --all-tables flag ensures you don't miss any tables that might store URL references.

3. Check File & Folder Permissions #

Incorrect permissions can prevent WordPress from writing to .htaccess or loading necessary files for subpages:

• Set WordPress root folders to 755 and files to 644 (this is standard for local environments).
• Ensure your local server user (e.g., www-data for Apache) has read/write access to the WordPress directory and .htaccess file.

4. Rule Out Plugin/Theme Conflicts #

Even if the homepage loads, a plugin or theme might be breaking subpage routing:

• Switch to a default WordPress theme (like Twenty Twenty-Four) and test subpages again.
• Disable all plugins, then re-enable them one by one, testing subpages after each to identify the culprit.

5. Validate Local Server Virtual Host Setup #

Double-check your local server's virtual host config:

• Ensure the DocumentRoot points directly to your WordPress root folder (not a subfolder).
• Confirm your local domain (e.g., yoursite.local) is correctly mapped to 127.0.0.1 in your system's hosts file.

6. Enable Debug Mode to Uncover Hidden Errors #

Since you're not seeing error messages, manually enable WordPress debugging to log issues:

• Edit your wp-config.php file and add/update these lines:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);
  

• Now, try loading a subpage, then check the wp-content/debug.log file for any error messages that might explain the failure.

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