本文系统讲解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（必需：包含 和导航等公共头部）
- footer.php（必需：包含 和脚本等公共底部）
- page.php（必需：用于普通页面，如“关于我们”）
- single.php（推荐：用于文章详情页）
- functions.php（必需：注册主题功能、菜单、脚本等）
⚠️ 若仅存在 index.html 而无上述 .php 文件，WordPress 将无法执行任何PHP逻辑，导致除静态首页外所有路由返回空白。
?️ 修复步骤：重建合规主题结构（5分钟完成）
步骤1：创建最小可行主题骨架
在当前主题目录下新建以下文件（使用UTF-8编码保存）：
index.php（主入口模板）
<?php get_header(); ?><main id="primary" class="site-main"><?php if (have_posts()) : while (have_posts()) : the_post(); ?><article id="post-<?php the_ID(); ?>" 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（标准化头部）
>
<meta charset="<?php bloginfo('charset'); ?>"><meta name="viewport" content="width=device-width, initial-scale=1"><?php wp_head(); ?>>
<header class="site-header"><!-- 此处可嵌入你的原生HTML导航 --><?php wp_nav_menu(['theme_location' => 'primary']); ?>
</header>
footer.php（标准化底部）
<footer class="site-footer"><!-- 你的原生HTML页脚 --></footer><?php wp_footer(); ?>
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 中
内容移至 header.php， 内容拆解为 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 主题。
