本文系统讲解wordpress网站出现“仅首页（index.html）正常、其余页面全白屏”的典型故障成因，涵盖模板结构缺失、主题文件不规范、迁移配置错误等核心问题，并提供可立即执行的调试与修复方案。
本文系统讲解wordpress网站出现“仅首页（index.html）正常、其余页面全白屏”的典型故障成因，涵盖模板结构缺失、主题文件不规范、迁移配置错误等核心问题，并提供可立即执行的调试与修复方案。
当你发现 WordPress 网站仅 index.html（静态首页）能正常显示，而所有 WordPress 动态页面（如 /about/、/blog/、/contact/）均呈现完全空白（无HTML源码、无HTTP响应体），且 WP_DEBUG 未输出错误、插件已禁用、.htaccess 已重置——这通常并非PHP致命错误或内存耗尽所致，而是主题模板体系严重缺失或结构错乱。根本原因在于：WordPress 的页面渲染依赖于一套标准化的模板层级（Template Hierarchy），而你当前使用的“基于 custom HTML-CSS-JS 构建的‘基础主题’”大概率未实现该机制。
? 关键诊断：你的主题缺少 WordPress 模板骨架
WordPress 不会直接读取 index.html 以外的静态 HTML 文件来渲染页面。它通过 PHP 模板文件（如 page.php、single.php、index.php）调用 get_header()、get_footer() 和 the_content() 等函数，动态组装 HTML。若主题目录中仅有 index.html 或未按规范提供必要模板文件，WordPress 将无法生成任何页面内容，最终返回空响应（HTTP 200 + 空 body）——这正是你看到“空白HTML页”的本质。
✅ 请立即检查主题根目录（/wp-content/themes/your-theme/）是否存在以下核心PHP文件：
- index.php（必需：主回退模板）
- header.php（必需：包含 <head> 和导航等公共头部）
- footer.php（必需：包含 </body> 和脚本等公共底部）
- page.php（必需：用于普通页面，如“关于我们”）
- single.php（推荐：用于文章详情页）
- functions.php（必需：注册主题功能、菜单、脚本等）
⚠️ 若仅存在 index.html 而无上述 .php 文件，WordPress 将无法执行任何PHP逻辑，导致除静态首页外所有路由返回空白。
?️ 修复步骤：重建合规主题结构（5分钟完成）
步骤1：创建最小可行主题骨架
在当前主题目录下新建以下文件（使用UTF-8编码保存）：
index.php（主入口模板）
安全的随机密码生成器。支持自定义长度、字符类型（大写/小写字母、数字、特殊符号），排除相似字符，批量生成。纯 Python 标准库，无需 API 密钥。
<?php get_header(); ?>
<main id="primary" class="site-main">
<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<header class="entry-header">
<h1 class="entry-title"><?php the_title(); ?></h1>
</header>
<div class="entry-content">
<?php the_content(); ?>
</div>
</article>
<?php endwhile; endif; ?>
</main>
<?php get_footer(); ?>header.php（标准化头部）
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo('charset'); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<header class="site-header">
<!-- 此处可嵌入你的原生HTML导航 -->
<?php wp_nav_menu(['theme_location' => 'primary']); ?>
</header>footer.php（标准化底部）
<footer class="site-footer">
<!-- 你的原生HTML页脚 -->
</footer>
<?php wp_footer(); ?>
</body>
</html>functions.php（启用主题功能）
<?php
// 启用主题支持
function your_theme_setup() {
add_theme_support('title-tag');
add_theme_support('post-thumbnails');
register_nav_menus([
'primary' => esc_html__('Primary Menu', 'your-theme'),
]);
}
add_action('after_setup_theme', 'your_theme_setup');
// 加载样式与脚本（复用原有CSS/JS）
function your_theme_scripts() {
wp_enqueue_style('main-css', get_template_directory_uri() . '/style.css');
wp_enqueue_script('main-js', get_template_directory_uri() . '/script.js', [], '1.0', true);
}
add_action('wp_enqueue_scripts', 'your_theme_scripts');? 提示：将你原有的 index.html 中 <head> 内容移至 header.php，<body> 内容拆解为 header.php / index.php / footer.php 三部分，并确保 style.css 和 script.js 路径正确。
步骤2：激活主题并刷新固定链接
- 进入后台 → 外观 → 主题，启用你刚修复的主题；
- 进入 设置 → 固定链接，点击“保存更改”（强制重写 .htaccess 规则）。
步骤3：验证与进阶优化
- 访问任意页面（如 /sample-page/），应显示标题与内容；
- 若仍空白，检查浏览器开发者工具（F12）→ Network 标签，确认请求返回状态码是否为 200 且 Response Body 非空；
- 使用 wp-content/debug.log 查看是否有 PHP Warning: Cannot modify header information 等提示（常见于 header.php 前存在空白字符）。
⚠️ 特别注意：All-in-One Migration 迁移陷阱
你提到使用 All-in-One Migration 迁移站点——该插件不会自动转换静态 HTML 为 WordPress 模板。它仅迁移数据库和文件，但若原主题未遵循 WordPress 模板规范，迁移后必然失效。务必手动补全上述PHP模板文件，而非依赖迁移工具“智能适配”。
✅ 总结：白屏≠崩溃，而是结构缺失
| 现象 | 真实原因 | 解决动作 |
|---|---|---|
| 仅 index.html 显示，其他页面空白 | 主题缺少 index.php/page.php 等核心模板 | 创建标准PHP模板骨架，分离HTML结构 |
| WP_DEBUG 无报错 | 错误类型为“逻辑缺失”而非PHP异常 | 不依赖日志，直接检查模板文件完整性 |
| Draft预览正常 | 文章编辑器渲染不依赖主题模板 | 证明内容数据完好，问题纯属前端渲染层 |
修复后，请立即关闭调试模式（将 wp-config.php 中 WP_DEBUG 设为 false），避免敏感信息泄露。至此，你的定制化HTML站点已真正成为可维护、可扩展的 WordPress 主题。
