رفع خطای RSS وردپرس؛ راهنمای کامل و قدم‌به‌قدم

اگه فید سایتتون باز نمی‌شه، خطای XML می‌بینید یا نوشته‌های تازه داخلش نمیان، معمولاً مشکل از خروجی اضافه فایل‌های PHP، تداخل قالب و افزونه، کش قدیمی یا تنظیمات سرور هست. توی این راهنما اول مطمئن می‌شیم چیزی که می‌بینید واقعاً خطاست؛ بعد با چند آزمایش امن، علت اصلی رو پیدا می‌کنیم و سراغ راه‌حل مناسب می‌ریم.

برای رفع خطای RSS وردپرس لازم نیست از همون اول افزونه تازه‌ای نصب کنید. بیشتر مشکل‌ها با بررسی آدرس فید، اعتبارسنجی خروجی، پاک کردن کش و آزمایش مرحله‌به‌مرحله قالب و افزونه‌ها پیدا می‌شن. فقط قبل از تغییر فایل‌ها حتماً بکاپ بگیرید تا اگه اشتباهی پیش اومد، بتونید سایتتون رو برگردونید.

فید RSS وردپرس چیه و از کجا بفهمیم خراب شده؟

فید RSS یک نسخه ساختاریافته از نوشته‌های تازه سایتتونه. این خروجی با XML ساخته می‌شه؛ XML یعنی قالب متنی منظمی که سرویس‌ها می‌تونن اطلاعاتی مثل عنوان نوشته، لینک، تاریخ و خلاصه محتوا رو ازش بخونن. خود وردپرس این فید رو به‌صورت خودکار تولید می‌کنه.

آدرس فید سایتتون رو چطور پیدا کنید؟

در بیشتر سایت‌های وردپرسی، کافیه /feed/ رو به انتهای آدرس اصلی سایت اضافه کنید. مثلاً اگه آدرس سایت https://example.com باشه، فید اصلی معمولاً در آدرس زیر دیده می‌شه:

https://example.com/feed/

دسته‌ها، برچسب‌ها و نویسنده‌ها هم می‌تونن فید جدا داشته باشن. برای نمونه، فید یک دسته معمولاً با اضافه کردن /feed/ به انتهای آدرس همون دسته باز می‌شه.

فرق خطای واقعی فید با نمایش ساده XML در مرورگر

اگه مرورگر یک صفحه ساده پر از متن و تگ‌هایی مثل <item> یا <title> نشون می‌ده، لزوماً فید خراب نیست. مرورگرها XML رو مثل یک صفحه معمولی طراحی نمی‌کنن و ممکنه فقط ساختار خامش رو نشون بدن. خطای واقعی معمولاً با یک پیام مشخص، صفحه خالی، کد وضعیت خطا یا محتوای نامرتبط همراهه.

نشانه‌های رایج خراب شدن فید وردپرس

• مرورگر پیام خطای تجزیه XML نشون می‌ده.
• قبل از شروع XML، متن، فاصله یا هشدار PHP دیده می‌شه.
• آدرس فید خطای ۴۰۴، ۵۰۰ یا دسترسی غیرمجاز می‌ده.
• فید کاملاً خالیه یا فقط بخشی از محتوا رو نشون می‌ده.
• نوشته‌های تازه بعد از انتشار وارد فید نمی‌شن.
• سرویس متصل به فید نمی‌تونه اطلاعات سایت رو دریافت کنه.

قبل از رفع خطای RSS وردپرس این کارها رو انجام بدید

از سایت و پایگاه داده نسخه پشتیبان بگیرید

قبل از ویرایش فایل‌های قالب، افزونه یا تنظیمات سرور، از فایل‌ها و پایگاه داده بکاپ بگیرید. اگه برای این کار راهنما لازم دارید، آموزش بکاپ گرفتن از سایت وردپرسی کمکتون می‌کنه. فایل بکاپ رو هم جایی جدا از هاست اصلی نگه دارید.

تغییرات رو ترجیحاً در محیط آزمایشی انجام بدید

محیط آزمایشی یا Staging یک کپی غیرعمومی از سایتتونه که می‌تونید تغییرات رو بدون به‌هم‌ریختن سایت اصلی توی اون امتحان کنید. اگه هاستتون این امکان رو داره، اول عیب‌یابی قالب، افزونه‌ها و کدهای PHP رو اونجا انجام بدید.

متن کامل خطا و زمان شروع مشکل رو یادداشت کنید

پیام خطا، آدرس دقیق فید و زمان تقریبی شروع مشکل رو ذخیره کنید. بعد بررسی کنید درست قبل از اون چه تغییری انجام دادید؛ مثلاً افزونه‌ای رو به‌روز کردید، قطعه‌کدی اضافه کردید یا تنظیمات کش و فایروال رو تغییر دادید. این اطلاعات محدوده جست‌وجو رو خیلی کوچک‌تر می‌کنه.

خطاهای رایج فید RSS وردپرس چه معنی‌ای دارن؟

خطای XML Declaration Not at Start of Entity

این خطا یعنی قبل از اعلان XML چیزی چاپ شده. اون چیز می‌تونه یک فاصله خالی، خط جدید، پیام خطای PHP یا خروجی یک قطعه‌کد باشه. پیام معمولاً شبیه نمونه زیره:

XML Parsing Error: XML or text declaration not at start of entity

در این وضعیت باید فایل‌های تازه‌ویرایش‌شده، مخصوصاً functions.php و wp-config.php، و افزونه‌هایی رو بررسی کنید که خروجی سفارشی تولید می‌کنن.

خطای Extra Content at the End of the Document

این پیام یعنی بعد از پایان سند XML، محتوای اضافه‌ای پیدا شده یا ساختار فید در میانه راه به هم خورده. خطای کدنویسی قالب یا افزونه، هشدار PHP و خروجی ناخواسته می‌تونن باعثش بشن.

نمایش کد HTML یا هشدار PHP داخل فید

خروجی فید باید XML سالم باشه. اگه داخل اون هشدارهایی مثل Warning، Notice یا بخشی از یک صفحه HTML می‌بینید، احتمالاً یک خطای PHP یا کد سفارشی قبل یا وسط فید چاپ می‌شه. متن خطا ممکنه نام فایل و شماره خط مشکل‌دار رو هم نشون بده. این اطلاعات رو ذخیره کنید، ولی نمایش خطاهای PHP رو روی سایت عمومی روشن نگه ندارید؛ چون ممکنه مسیر فایل‌ها و اطلاعات فنی سایتتون دیده بشه.

خطاهای ۴۰۴، ۵۰۰ و دسترسی غیرمجاز

خطای ۴۰۴ یعنی سرور مسیر فید رو پیدا نکرده. ذخیره دوباره پیوندهای یکتا یکی از راه‌های رایج آزمایش این مشکله، ولی غیرفعال شدن فید، قوانین وب‌سرور یا افزونه‌های امنیتی هم می‌تونن عاملش باشن. خطای ۵۰۰ ممکنه از خطای PHP یا تنظیمات داخلی سرور بیاد. خطای ۴۰۳ یا پیام دسترسی غیرمجاز هم می‌تونه به فایروال، قوانین امنیتی یا تنظیمات دسترسی مربوط باشه؛ پس کد خطا به‌تنهایی علت دقیق رو مشخص نمی‌کنه.

خالی بودن فید یا نمایش ندادن نوشته‌های تازه

فید خالی همیشه به معنی خرابی XML نیست. ممکنه نوشته منتشرشده‌ای نداشته باشید، نوع محتوایی که دنبالش هستید داخل فید قرار نگیره یا یک نسخه کش‌شده قدیمی نمایش داده بشه. تنظیمات نمایش خلاصه یا متن کامل هم شکل محتوا رو عوض می‌کنه، ولی نباید باعث ناپدید شدن همه نوشته‌ها بشه.

چطور علت خطای RSS وردپرس رو پیدا کنید؟

آدرس اصلی فید رو مستقیم باز کنید

آدرس yourdomain.com/feed/ رو در یک پنجره ناشناس مرورگر باز کنید. این کار کمک می‌کنه اثر کش مرورگر و ورود مدیر کمتر بشه، ولی کش سایت یا CDN رو پاک نمی‌کنه. پیام کامل خطا و هر متنی که قبل از XML دیده می‌شه رو یادداشت کنید.

فید رو با ابزار اعتبارسنج W3C بررسی کنید

آدرس فید رو در ابزار اعتبارسنج فید W3C وارد کنید و گزینه Check رو بزنید. اعتبارسنج یعنی ابزاری که ساختار فید رو بررسی می‌کنه و محل تقریبی خطا رو نشون می‌ده. هشدارها همیشه باعث از کار افتادن فید نمی‌شن، ولی خطاهای اصلی باید بررسی بشن.

کش سایت، افزونه کش و CDN رو پاک کنید

اول کش افزونه وردپرس، بعد کش هاست یا سرور و در آخر کش CDN رو پاک کنید. CDN سرویسیه که نسخه‌هایی از محتوای سایت رو روی چند سرور نگه می‌داره تا سریع‌تر تحویلش بده. در پایان، کش مرورگر رو هم پاک کنید یا فید رو در پنجره ناشناس باز کنید. اگه از افزونه کش استفاده می‌کنید، راهنمای تنظیم و پاک کردن کش وردپرس هم می‌تونه مفید باشه.

پیوندهای یکتا رو دوباره ذخیره کنید

در پیشخوان به «تنظیمات ← پیوندهای یکتا» برید و بدون تغییر گزینه‌ها، روی «ذخیره تغییرات» کلیک کنید. وردپرس با این کار قوانین بازنویسی آدرس‌ها رو دوباره می‌سازه. بعد کش رو پاک کنید و آدرس فید رو دوباره باز کنید.

تداخل افزونه‌ها رو مرحله‌به‌مرحله بررسی کنید

در محیط آزمایشی همه افزونه‌ها رو موقتاً غیرفعال کنید. اگه فید درست شد، افزونه‌ها رو یکی‌یکی فعال کنید و بعد از هر فعال‌سازی فید رو آزمایش کنید. افزونه‌ای که با فعال شدنش خطا برمی‌گرده، محتمل‌ترین عامل مشکله. اگه پیشخوان باز نمی‌شه، خودتون سراغ تغییر پوشه افزونه‌ها نرید؛ از پشتیبانی هاست بخواید افزونه‌ها رو موقتاً و بدون حذف اطلاعات غیرفعال کنه.

قالب رو در محیط آزمایشی موقتاً تغییر بدید

اگه غیرفعال کردن افزونه‌ها نتیجه‌ای نداشت، در نسخه آزمایشی سایت یکی از قالب‌های پیش‌فرض وردپرس رو فعال کنید. درست شدن فید بعد از تغییر قالب نشون می‌ده مشکل احتمالاً در functions.php، هوک‌های فید یا یکی از فایل‌های قالب فعلیه.

گزارش خطاهای PHP و سرور رو بررسی کنید

PHP زبان برنامه‌نویسیه که بخش اصلی وردپرس با اون اجرا می‌شه. گزارش خطا یا Error Log معمولاً از بخش گزارش‌ها یا خطاهای پنل هاست در دسترسه و ممکنه نام فایل، شماره خط و زمان رخ دادن مشکل رو نشون بده. نام و جای این بخش در هر پنل فرق می‌کنه. اگه پیداش نکردید، از پشتیبانی هاست بخواید گزارش مربوط به زمان باز کردن آدرس فید رو بررسی کنه. خطاها باید در گزارش ثبت بشن، ولی بهتره جزئیاتشون روی سایت عمومی نمایش داده نشه.

روش‌های رفع خطای RSS وردپرس

حذف فاصله یا خروجی اضافه از فایل‌های PHP

اگه خطا بعد از ویرایش یک فایل PHP شروع شده، همون فایل رو با نسخه سالم مقایسه کنید. قبل از هر تغییر، یک کپی از فایل فعلی بگیرید و فایل رو مستقیم روی سایت اصلی ویرایش نکنید.

• functions.php قالب و wp-config.php رو بررسی کنید.
• قبل از تگ باز <?php نباید فاصله، خط خالی، متن یا HTML باشه.
• اگه فایل فقط کد PHP داره، معمولاً بهتره تگ بسته ?> در انتهای فایل نوشته نشه تا خروجی ناخواسته ایجاد نشه.
• پیام‌های Warning و Notice رو در گزارش خطا ثبت و علت اصلی اون‌ها رو برطرف کنید، ولی اون‌ها رو روی سایت عمومی نمایش ندید.
• فایل رو با کدگذاری UTF-8 بدون BOM ذخیره کنید. BOM چند بایت پنهانه که بعضی ویرایشگرها اول فایل می‌ذارن و ممکنه قبل از XML خروجی بسازه.

اگه با کدنویسی و مدیریت فایل آشنا نیستید، فایل‌ها رو خودتون تغییر ندید. نام فایل و خط گزارش‌شده رو برای توسعه‌دهنده یا پشتیبانی هاست بفرستید.

رفع تداخل افزونه‌ها با روش امن

افزونه مشکل‌دار رو به آخرین نسخه سازگار به‌روز کنید و تغییرات سازنده اون رو بخونید. اگه خطا ادامه داشت، افزونه رو غیرفعال نگه دارید و با پشتیبانی سازنده تماس بگیرید. نسخه افزونه رو از سایت‌های متفرقه دانلود نکنید. قبل از جایگزینی افزونه هم مطمئن بشید قابلیت موردنیازتون رو واقعاً پوشش می‌ده.

بررسی خطای قالب و کدهای سفارشی

قطعه‌کدهایی که تازه به فایل قالب، افزونه اختصاصی یا ابزار درج کد اضافه کردید موقتاً غیرفعال کنید. بعد از هر تغییر، فید رو آزمایش کنید. اگه با قالب پیش‌فرض فید سالمه، نتیجه آزمایش و گزارش خطا رو برای سازنده قالب بفرستید.

پاک کردن کش وردپرس، مرورگر، سرور و CDN

کش‌ها رو از نزدیک‌ترین لایه به سایت تا دورترین لایه پاک کنید: افزونه وردپرس، کش سرور یا هاست، CDN و مرورگر. بعد چند دقیقه صبر کنید و آدرس فید رو دوباره باز کنید. می‌تونید برای آزمایش از پارامتری مثل ?feed-check=1 هم استفاده کنید، ولی این روش تضمین نمی‌کنه کش همه سرورها یا CDNها دور زده بشه و جای پاک کردن واقعی کش رو نمی‌گیره.

رفع خطای پیوند یکتا و بازسازی قوانین بازنویسی

ذخیره دوباره صفحه «تنظیمات ← پیوندهای یکتا» قوانین مسیر /feed/ رو دوباره می‌سازه و ممکنه بعضی خطاهای ۴۰۴ رو برطرف کنه. اگه خطای ۴۰۴ باقی موند، پشتیبانی هاست باید قوانین بازنویسی وب‌سرور و فایل تنظیمات مربوط به اون رو بررسی کنه. فایل‌های تنظیمات سرور رو بدون بکاپ و شناخت کافی ویرایش نکنید.

بررسی تنظیمات فید در پیشخوان وردپرس

به «تنظیمات ← خواندن» برید. تعداد نوشته‌های نمایش‌داده‌شده در خوراک و گزینه نمایش متن کامل یا خلاصه رو بررسی کنید. این تنظیمات بیشتر روی مقدار و شکل محتوای فید اثر دارن و خطای XML رو تعمیر نمی‌کنن، ولی می‌تونن دلیل کم بودن یا کوتاه بودن مطالب باشن.

اگه قبلاً با کد یا افزونه فید رو خاموش کردید، همون تغییر رو هم بررسی کنید. راهنمای غیرفعال کردن فید وردپرس محل‌های رایج این تنظیم رو نشون می‌ده؛ برای فعال شدن دوباره فید باید کد یا تنظیم مربوط به غیرفعال‌سازی برداشته بشه.

رفع خطاهای مربوط به سرور، فایروال و دسترسی‌ها

اگه فقط درخواست‌های فید با خطای ۴۰۳ یا ۵۰۰ روبه‌رو می‌شن، قوانین فایروال، افزونه امنیتی و محدودیت‌های هاست رو به‌عنوان علت‌های احتمالی بررسی کنید. آدرس دقیق، زمان آزمایش و کد خطا رو برای پشتیبانی هاست بفرستید. از اون‌ها بخواید گزارش درخواست فید و قوانین مسدودکننده رو بررسی کنن.

اگه فقط فید یک دسته، برچسب یا نویسنده خراب شده چیکار کنید؟

وقتی فید اصلی سالمه ولی فید یک بخش خاص خطا می‌ده، ممکنه مشکل به محتوای همون بخش، نشانی اون یا کدی مربوط باشه که فقط روی همون آرشیو اجرا می‌شه.

• آدرس همون دسته، برچسب یا نویسنده رو باز کنید و بعد /feed/ رو به انتهای اون اضافه کنید.
• آخرین نوشته‌های اون بخش رو یکی‌یکی بررسی کنید. اگه مشکل بعد از انتشار یک نوشته شروع شده، نسخه آزمایشی اون نوشته رو بدون کدهای سفارشی امتحان کنید.
• کد کوتاه یا Shortcode، HTML ناقص و نویسه‌های نامعتبر رو بررسی کنید. کد کوتاه یک عبارت داخل کروشه‌ست که وردپرس یا افزونه اون رو به محتوای کامل تبدیل می‌کنه.
• اگه آدرس آرشیو رو تغییر دادید، پیوندهای یکتا رو دوباره ذخیره و همه لایه‌های کش رو پاک کنید.

چطور مطمئن بشید فید وردپرس درست شده؟

فید رو دوباره در مرورگر باز کنید

آدرس اصلی فید رو در پنجره ناشناس باز کنید. نباید قبل از XML پیام خطا، متن اضافه یا کد HTML نامرتبط ببینید. نمایش خام تگ‌های XML به‌تنهایی نشونه خرابی نیست.

نتیجه رو با اعتبارسنج W3C آزمایش کنید

فید رو دوباره در اعتبارسنج W3C بررسی کنید. اگه خطای اصلی برطرف شده ولی چند هشدار باقی مونده، متن هر هشدار رو جدا بخونید؛ بعضی هشدارها پیشنهاد بهبود هستن و جلوی خوانده شدن فید رو نمی‌گیرن.

نمایش آخرین نوشته‌ها و تاریخ انتشار رو بررسی کنید

عنوان و تاریخ چند نوشته آخر رو با سایت مقایسه کنید. تعداد آیتم‌ها هم باید با تنظیمی که در بخش «خواندن» انتخاب کردید هماهنگ باشه. اگه یک نوشته خاص دیده نمی‌شه، وضعیت انتشار، تاریخ و دسته‌بندی اون رو بررسی کنید.

کش سرویس‌های متصل به فید رو تازه‌سازی کنید

بعضی سرویس‌ها فید رو با فاصله زمانی مشخص دریافت و ذخیره می‌کنن. بعد از تعمیر فید، گزینه تازه‌سازی یا همگام‌سازی سرویس رو بزنید. اگه چنین گزینه‌ای نداره، کمی زمان بدید تا دوباره فید رو دریافت کنه.

بعد از رفع خطا چطور از خراب شدن دوباره فید جلوگیری کنید؟

• قالب و افزونه‌ها رو فقط از منابع معتبر بگیرید و اون‌ها رو منظم به‌روز کنید.
• قبل از به‌روزرسانی‌های مهم بکاپ بگیرید. برای مدیریت راحت‌تر می‌تونید راهنمای به‌روزرسانی خودکار وردپرس و افزونه‌ها رو بخونید.
• کدهای سفارشی رو اول در محیط آزمایشی امتحان کنید و تغییرات هر فایل رو ثبت کنید.
• گزارش خطاهای سرور و بخش «ابزارها ← سلامت سایت» رو دوره‌ای بررسی کنید.
• بعد از تغییر قالب، نصب افزونه یا ویرایش کد، آدرس فید رو باز و اعتبارسنجی کنید.
• فید رو با یک سرویس پایش یا بررسی دوره‌ای زیر نظر بگیرید تا خطا رو زودتر متوجه بشید.

سؤال‌های رایج

جمع‌بندی

برای رفع خطای RSS وردپرس اول آدرس /feed/ رو مستقیم باز و خروجی اون رو با اعتبارسنج W3C بررسی کنید. بعد کش‌ها رو پاک کنید، پیوندهای یکتا رو دوباره ذخیره کنید و تداخل افزونه و قالب رو در محیط آزمایشی بسنجید. اگه داخل فید هشدار PHP یا متن اضافه می‌بینید، فایل و خطی که گزارش خطا نشون می‌ده مهم‌ترین سرنخ شماست.

تغییر فایل‌های PHP و تنظیمات سرور برای کاربر مبتدی ریسک داره. پس قبل از هر کاری بکاپ بگیرید و اگه علت دقیق رو پیدا نکردید، اطلاعات آزمایش‌ها رو برای پشتیبانی هاست یا توسعه‌دهنده بفرستید. با این روش، به‌جای امتحان کردن راه‌حل‌های تصادفی، مشکل رو از ریشه پیدا می‌کنید.

تیم تولید محتوا

ما در تیم تولید محتوای میهن وردپرس در تلاش هستیم تا بهترین مقالات آموزشی در زمینه وردپرس و کسب‌و‌کارهای اینترنتی را تهیه کنیم. صحت محتوای این صفحه توسط رضا راد بررسی خواهد شد.