Media WordPress Bị Lỗi Sau Migrate Website: Nguyên Nhân Và Cách Khắc Phục Triệt Để

Khi bạn thực hiện di chuyển website WordPress sang host mới hoặc tên miền khác, lỗi media là một trong những vấn đề phổ biến nhất. Hình ảnh không hiển thị, đường dẫn file bị hỏng, hoặc thư viện media trống rỗng sau migrate khiến nhiều người đau đầu. Trong bài viết này, chúng

Bản Chất Của Lỗi Media Sau Khi Migrate WordPress

Sau khi di chuyển website, các đường dẫn tuyệt đối trong cơ sở dữ liệu (database) vẫn giữ nguyên URL cũ. WP-Cron, các plugin cache, hoặc cấu hình server mới cũng có thể làm gián đoạn việc hiển thị media. Cụ thể, WordPress lưu trữ đường dẫn hình ảnh dưới dạng URL đầy đủ (ví dụ: https://domaincu.com/wp-content/uploads/2024/01/anh.jpg). Khi bạn chuyển sang domain mới, những URL này không tự động cập nhật, dẫn đến lỗi 404 hoặc hiển thị hình ảnh bị vỡ.

Nguyên Nhân Khiến Media WordPress Bị Lỗi Sau Migrate

Có nhiều yếu tố gây ra lỗi media. Đường Dẫn Tuyệt Đối Trong Database Không Được Cập Nhật

Đây là nguyên nhân số một. Khi bạn di chuyển website, các trường như guid, post_content, meta_value trong database vẫn chứa URL cũ. Nếu không thay thế chúng bằng URL mới, media sẽ không thể tải về đúng vị trí.

2. Thiếu File.htaccess Hoặc Cấu Hình Apache/Nginx Sai

File.htaccess đóng vai trò định tuyến URL. Sau migrate, nếu file này không được tạo lại hoặc bị hỏng, WordPress không thể xử lý đường dẫn media đúng cách. Đối với server Nginx, cấu hình rewrite cũng cần được kiểm tra.

3. Plugin Cache Hoặc CDN Giữ Phiên Bản Cũ

Các plugin như WP Rocket, W3 Total Cache hoặc dịch vụ CDN (Cloudflare, KeyCDN) có thể lưu cache các URL media cũ. Điều này khiến trình duyệt hoặc server vẫn trỏ về đường dẫn không tồn tại sau migrate.

4. Quyền Truy Cập File (Permission) Không Đúng

Thư mục wp-content/uploads cần có quyền 755 hoặc 775 để web server có thể đọc và ghi. Nếu sau migrate quyền bị thay đổi, media sẽ không hiển thị.

Hướng Dẫn Khắc Phục WordPress Media Lỗi Sau Migrate

Thực hiện các bước dưới đây theo đúng thứ tự để xử lý triệt để lỗi media.

Bước 1: Cập Nhật URL Trong Database Bằng Plugin Hoặc SQL

Cách an toàn nhất là sử dụng plugin Better Search Replace. Cài đặt và chạy plugin này, tìm kiếm URL cũ (ví dụ: https://domaincu.com) và thay thế bằng URL mới (ví dụ: https://domainmoi.com). Chọn tất cả các bảng trong database và thực hiện. Lưu ý: Nên sao lưu database trước khi chạy.

Nếu bạn muốn thực hiện thủ công qua phpMyAdmin, hãy dùng câu lệnh SQL:

UPDATE wp_posts SET post_content = REPLACE(post_content, 'https://domaincu.com', 'https://domainmoi.com');
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'https://domaincu.com', 'https://domainmoi.com');
UPDATE wp_options SET option_value = REPLACE(option_value, 'https://domaincu.com', 'https://domainmoi.com');

Bước 2: Kiểm Tra Và Cập Nhật File.htaccess

Đi đến Settings > Permalinks và nhấn Save Changes mà không thay đổi gì. WordPress sẽ tự động ghi lại file.htaccess. Nếu bạn dùng Nginx, hãy kiểm tra file cấu hình site và thêm rules rewrite phù hợp.

Bước 3: Xóa Cache Toàn Bộ Hệ Thống

Xóa cache của plugin cache, cache trình duyệt, và nếu dùng CDN hãy purge cache. Với Cloudflare,

Trình duyệt có thể đã cache ảnh từ phiên bản cũ. Bạn hãy xóa cache trình duyệt hoặc dùng chế độ ẩn danh để kiểm tra. Nếu vẫn lỗi, hãy kiểm tra đường dẫn trực tiếp của ảnh (view source) để xem URL đã đúng chưa.

Làm thế nào để sửa lỗi media khi dùng WordPress multisite?

Với multisite, mỗi site con có thư mục uploads riêng (wp-content/uploads/sites/ID). Bạn cần thực hiện search replace trên từng site riêng biệt hoặc dùng plugin hỗ trợ multisite. Đảm bảo cập nhật cả URL trong bảng wp_blogs và wp_site.

Có cần cài lại plugin media library sau migrate không?

Nếu plugin media library của bạn hoạt động bình thường trước đó, không cần cài lại. Tuy nhiên, nếu plugin đó lưu cache hoặc cấu hình riêng, hãy vào cài đặt plugin và kiểm tra lại đường dẫn.

Kết Luận

Lỗi media sau migrate website WordPress là vấn đề kỹ thuật phổ biến nhưng hoàn toàn có thể khắc phục nếu bạn hiểu rõ nguyên nhân. Việc cập nhật URL trong database, kiểm tra quyền thư mục, xóa cache và tái tạo thumbnail là các bước cốt lõi. Để tránh wordpress media sau migrate website bị lỗi trong tương lai, hãy luôn thực hiện quy trình migrate có kiểm soát, backup dữ liệu và sử dụng công cụ chuyên nghiệp. Nếu bạn gặp khó khăn, hãy liên hệ với chuyên gia WordPress để được hỗ trợ kịp thời.