WordPress Upload PDF Lỗi: Nguyên Nhân & Cách Khắc Phục Toàn Diện (2025)

Gặp lỗi khi upload file PDF lên WordPress là vấn đề phổ biến khiến nhiều người dùng đau đầu. Tình trạng WordPress upload PDF lỗi có thể xuất phát từ nhiều nguyên nhân như giới hạn kích thước file, cấu hình máy chủ, xung đột plugin hoặc lỗi quyền truy cập thư mục. Bài viết này sẽ đi sâu vào từng nguyên nhân và hướng dẫn bạn các bước khắc phục chi tiết, giúp website vận hành trơn tru.

Bản Chất Của Lỗi Upload PDF Trong WordPress

WordPress về cơ bản hỗ trợ upload file PDF thông qua Media Library. Tuy nhiên, hệ thống này bị ràng buộc bởi cấu hình PHP của máy chủ, quyền thư mục wp-content/uploads và các thiết lập bảo mật. Khi một trong những yếu tố này bị giới hạn hoặc sai sót, quá trình tải lên sẽ thất bại và hiển thị thông báo lỗi.

Hiểu đơn giản, mỗi lần bạn nhấn “Upload” là WordPress gửi file đến server thông qua giao thức HTTP. Server sẽ kiểm tra dung lượng, loại file (MIME type), quyền ghi thư mục và giới hạn thời gian thực thi. Nếu bất kỳ bước nào không đáp ứng yêu cầu, lỗi lập tức xuất hiện.

Các Dạng Lỗi WordPress Upload PDF Thường Gặp

Dựa trên hàng trăm trường hợp thực tế, có thể phân loại thành 4 nhóm chính:

Loại lỗi	Thông báo điển hình	Nguyên nhân chính
Lỗi kích thước file	“The uploaded file exceeds the upload_max_filesize directive”	Giới hạn PHP quá thấp
Lỗi HTTP Error	“HTTP Error” hoặc “An error occurred”	Memory limit hoặc timeout
Lỗi loại file không hỗ trợ	“Sorry, this file type is not permitted”	Hạn chế MIME type
Lỗi không tìm thấy thư mục	“Unable to create directory”	Quyền thư mục upload sai

Nguyên Nhân Chi Tiết Khiến WordPress Upload PDF Lỗi

1. Giới Hạn PHP Quá Thấp (Upload Max Filesize, Post Max Size)

Mặc định, nhiều hosting chia sẻ chỉ cho phép upload tối đa 2MB hoặc 8MB. Nếu file PDF của bạn vượt quá con số này, lỗi ngay lập tức bị chặn. Bạn cần kiểm tra bốn thông số quan trọng trong PHP: upload_max_filesize, post_max_size, max_execution_time và memory_limit. Cả bốn phải được điều chỉnh đồng bộ.

2. Quyền Thư Mục wp-content/uploads Không Chính Xác

Thư mục uploads phải có quyền ghi (thường là 755 cho thư mục và 644 cho file). Nếu quyền bị đặt sai (ví dụ 444), WordPress không thể tạo thư mục con hoặc lưu file PDF, dẫn đến lỗi “Unable to create directory”. Điều này thường xảy ra sau khi di chuyển hosting hoặc cài đặt lại server.

3. Xung Đột Plugin Hoặc Theme

Các plugin bảo mật (Wordfence, iThemes Security), plugin nén ảnh, plugin tối ưu hiệu suất có thể vô tình chặn upload PDF. Ngoài ra, một số theme custom code không đúng chuẩn cũng thay đổi hành vi Media Library. Thử nghiệm tắt toàn bộ plugin và chuyển về theme mặc định (Twenty Twenty-Three) để kiểm tra.

4. Lỗi.htaccess Hoặc Cấu Hình Server

File.htaccess trong thư mục gốc WordPress có thể bị hỏng hoặc chứa các directive hạn chế upload. Một số máy chủ sử dụng Nginx hoặc LiteSpeed có cấu hình riêng về giới hạn upload – nếu không được đồng bộ, lỗi sẽ xảy ra ngay cả khi PHP đã đúng.

5. Thiếu Phần Mở Rộng PHP Cần Thiết

Để upload file PDF, PHP cần có các extension như gd hoặc imagick (dùng cho thumbnail), fileinfo (kiểm tra MIME type). Nếu thiếu extension, WordPress có thể từ chối file mặc dù dung lượng hợp lệ.

Hướng Dẫn Khắc Phục Lỗi Upload PDF Trong WordPress (Từng Bước Cụ Thể)

Bước 1: Kiểm Tra Log Lỗi WordPress và Server

Đầu tiên, kích hoạt WP_DEBUG trong file wp-config.php để xem thông báo chi tiết:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Sau đó truy cập file wp-content/debug.log để tìm dòng lỗi cụ thể. Nếu không có quyền sửa file,

Đây là lỗi do dung lượng file PDF vượt quá giới hạn cho phép trong cấu hình PHP. Bạn cần tăng giá trị upload_max_filesize và post_max_size trong php.ini,.htaccess hoặc wp-config.php.

Làm thế nào để xem dung lượng upload tối đa hiện tại?

Vào wp-admin → Media → Add New, xem dòng chữ nhỏ phía dưới: “Maximum upload file size: 8 MB”. Hoặc vào Tools → Site Health → Info → Server để thấy giá trị upload_max_filesize.

Tại sao tôi đã tăng giới hạn PHP nhưng vẫn bị lỗi HTTP Error?

Lỗi HTTP Error thường liên quan đến memory_limit hoặc max_execution_time. Nếu file quá lớn, server cần nhiều bộ nhớ và thời gian để xử lý. Hãy kiểm tra cả hai giá trị này. Ngoài ra, plugin bảo mật hoặc tường lửa cũng có thể chặn request upload.

Có plugin nào miễn phí giúp upload PDF dễ dàng hơn không?

Các plugin như WP Maximum Upload File Size, Increase Upload Max Filesize hoặc Big File Uploads đều miễn phí và hỗ trợ tăng giới hạn. Tuy nhiên, chúng chỉ hoạt động nếu hosting cho phép ghi đè bằng PHP.

Lỗi “Sorry, this file type is not permitted” khi upload PDF?

WordPress mặc định cho phép PDF (application/pdf). Nếu gặp lỗi này, có thể plugin bảo mật hoặc theme đã thay đổi danh sách MIME type allowed. Hãy thêm dòng sau vào file functions.php của theme con:

add_filter('upload_mimes', function($mimes){ $mimes['pdf'] = 'application/pdf'; return $mimes;
});

Kết Luận

Lỗi WordPress upload PDF lỗi tuy phiền phức nhưng hoàn toàn có thể xử lý nếu bạn hiểu rõ nguyên nhân gốc rễ. Từ việc kiểm tra giới hạn PHP, quyền thư mục, xung đột plugin cho đến cấu hình server – mỗi bước đều có giải pháp cụ thể. Hãy bắt đầu bằng cách xem log lỗi, sau đó áp dụng tuần tự các phương pháp từ đơn giản đến nâng cao. Nếu vẫn thất bại, liên hệ nhà cung cấp hosting để được hỗ trợ trực tiếp. Với hướng dẫn chi tiết này, bạn hoàn toàn có thể chinh phục mọi rào cản khi upload PDF lên WordPress.