修復 WordPress Feed 錯誤：Fix RSS Feeds 外掛原理解析

修復 WordPress Feed 錯誤：Fix RSS Feeds 外掛原理解析

WordPress Feed 輸出異常常見症狀：Chrome 顯示「Document is empty」、IE 提示「文檔頂層存在無效內容」、Feed 閱讀器報錯。實際上 WordPress 核心輸出正常，問題多在某個 PHP 檔案輸出了 BOM、空白字符或換行符導致 XML 聲明前有輸出。

常見錯誤訊息

This page contains the following errors:
error on line 1 at column 1: Document is empty

或 IE：文檔頂層存在無效內容

傳統排查清單（手動修復）

1. 檢查 wp-config.php：?> 之後不可有任何空白/換行（建議刪除結尾 ?>）
2. 檢查 functions.php（主題與外掛）：同理，結尾勿留空白
3. 檢查 wp-rss2.php、wp-atom.php 核心檔（近期未動可略過）
4. 發佈新文章觸發 Feed 重建驗證
5. 停用所有外掛、切換預設主題逐一排查

一鍵修復：Fix RSS Feeds 外掛實測有效

安裝啟用「Fix RSS Feeds」外掛，點擊修復按鈕即可解決。更神奇的是刪除外掛後不反彈，說明它修改了核心檔案而非掛載過濾器。

原理揭秘：修改 wp-blog-header.php

外掛實際將根目錄 wp-blog-header.php 替換為帶輸出緩衝版本：

<?php
/**
 * Loads the WordPress environment and template.
 * @package WordPress
 */
if (!isset($wp_did_header)) {
  $wp_did_header = true;
  ob_start(); // 開啟輸出緩衝，捕獲前面的雜訊
  require_once(dirname(__FILE__) . '/wp-load.php');
  ob_end_clean(); // 清空緩衝，確保 XML 聲明在最開頭
  wp();
  require_once(ABSPATH . WPINC . '/template-loader.php');
}
?>

核心關鍵：ob_start() + ob_end_clean()

手動修復步驟（無需外掛）

1. 備份 wp-blog-header.php
2. 用上述代碼替換原檔案內容
3. 刷新 Feed 驗證（或發新文觸發重建）

根本預防：編碼規範

• 所有 PHP 檔案統一使用 UTF-8 無 BOM 編碼儲存
• 純 PHP 檔案省略結尾 ?>，避免後續誤輸入空白
• 外掛/主題開發遵循 WordPress 編碼標準

驗證工具

• W3C Feed Validation Service — 官方標準驗證
• 瀏覽器直接訪問 /feed/ 查看原始碼首行是否為 <?xml version="1.0" encoding="UTF-8"?>

總結：Feed 錯誤 90% 由「XML 聲明前有輸出」引起。ob_start()/ob_end_clean() 是治標更治本的方案，比逐個檢查檔案高效得多。建議直接修改 wp-blog-header.php 一勞永逸。

1. 上一篇文章： WordPress Gravatar 頭像本地緩存與優化完整方案
2. 下一篇文章： WordPress 自定義字段與後台 Meta Box 完整開發指南

PHP 相關知識

Linux 下搭建 XAMPP 一體化 PHP 開發環境完整教程

從下載、安裝、配置虛擬主機到安全加固的全流程實操 XAMPP

PHP 內核探索：變數與引用機制深度解析（二）

PHP 內核探索：變數與引用機制深度解析（二） 延續上篇 z

Windows 安裝 Laravel Homestead 開發環境完整指南

前言 Homestead 是 Laravel 官方提供的預打

NetBeans 8.2 新功能預覽：完整支援 PHP 7 語法特性

NetBeans 8.2 新功能預覽：完整支援 PHP 7