Khắc phục lỗi WordPress Uploads Directory Missing – Hướng dẫn chi tiết từ A đến Z

Lỗi “WordPress uploads directory missing” là một trong những sự cố phổ biến khiến nhiều người dùng WordPress hoang mang. Khi gặp thông báo này, bạn không thể tải lên hình ảnh, file PDF, hay bất kỳ tệp tin đa phương tiện nào vào Media Library. Nguyên nhân thường đến từ việc thư mục /wp-content/uploads/ bị xóa, không tồn tại hoặc cấu hình sai quyền truy cập. Bài viết này sẽ giúp bạn hiểu rõ bản chất lỗi, các nguyên nhân tiềm ẩn và cách khắc phục triệt để, từ cơ bản đến nâng cao, đảm bảo website của bạn hoạt động trơn tru trở lại.

WordPress Uploads Directory Missing là gì?

Thư mục uploads (thường nằm tại /wp-content/uploads/) là nơi WordPress lưu trữ tất cả các tệp tin bạn tải lên qua Media Library: hình ảnh, video, tài liệu, âm thanh, v.v. Mỗi khi bạn upload một file, WordPress sẽ tự động ghi file vào thư mục này, đồng thời tạo các thư mục con theo năm/tháng (ví dụ: /uploads/2025/04/).

Khi hệ thống báo lỗi “The uploads directory is missing” hoặc “Uploads folder not found”, điều đó có nghĩa là WordPress không tìm thấy thư mục mặc định hoặc không thể ghi dữ liệu vào đó. Hậu quả là chức năng Media Library bị vô hiệu hóa hoàn toàn, ảnh hưởng đến khả năng quản lý nội dung hình ảnh và các tệp đính kèm trên toàn bộ website.

Nguyên nhân phổ biến gây ra lỗi Uploads Directory Missing

Việc xác định chính xác nguyên nhân giúp bạn chọn phương án khắc phục phù hợp nhất. Thư mục uploads bị xóa hoặc di chuyển

Trong quá trình bảo trì, sao lưu hoặc cập nhật website, thư mục /wp-content/uploads/ có thể vô tình bị xóa bởi người dùng hoặc plugin. Đôi khi, khi bạn di chuyển toàn bộ site sang host mới, thư mục uploads không được copy đầy đủ.

2. Sai quyền truy cập (permissions)

WordPress yêu cầu thư mục uploads phải có quyền ghi (write) cho máy chủ web. Nếu quyền (permissions) bị đặt sai (ví dụ: 644 thay vì 755 cho thư mục), WordPress không thể tạo hay ghi file mới. Điều này thường xảy ra sau khi thay đổi cấu hình server hoặc cài đặt plugin bảo mật quá mức.

3. Cấu hình sai trong wp-config.php

Một số chủ website hoặc plugin có thể can thiệp vào đường dẫn uploads bằng cách thêm dòng define( 'UPLOADS', '...' ); vào file wp-config.php. Nếu đường dẫn này không đúng, WordPress sẽ báo lỗi thư mục không tồn tại.

4. Lỗi từ plugin hoặc theme

Các plugin tối ưu hóa, bảo mật, hoặc tùy chỉnh Media Library đôi khi thay đổi cấu trúc thư mục uploads. Khi plugin bị lỗi hoặc xung đột, thư mục mặc định có thể bị ảnh hưởng. Cũng có trường hợp theme sử dụng chức năng custom upload path và không khai báo đúng.

5. Vấn đề từ phía máy chủ (hosting)

Một số nhà cung cấp hosting có thể vô tình xóa hoặc khóa thư mục uploads trong quá trình quét bảo mật, hoặc do cấu hình.htaccess chặn quyền ghi. Ngoài ra, dung lượng ổ cứng đầy cũng khiến WordPress không thể tạo thư mục mới.

Hướng dẫn khắc phục lỗi WordPress Uploads Directory Missing

Bạn nên thực hiện tuần tự để tiết kiệm thời gian.

Bước 1: Kiểm tra thư mục uploads qua FTP hoặc File Manager

Đăng nhập vào hosting bằng FTP (FileZilla, WinSCP…) hoặc sử dụng File Manager trong cPanel. Duyệt đến thư mục /wp-content/. Nếu bạn thấy thư mục uploads màu xanh (tồn tại) thì vấn đề có thể nằm ở quyền truy cập. Nếu không thấy thư mục uploads, bạn cần tạo lại.

Bước 2: Tạo lại thư mục uploads và thư mục con

Nếu thư mục uploads bị mất, hãy tạo thủ công:

• Tạo thư mục mới tên uploads bên trong /wp-content/
• Đặt quyền (permissions) cho thư mục này là 755 (đối với thư mục) hoặc 755 cho phép ghi từ máy chủ.
• Bên trong uploads, tạo thư mục con theo định dạng năm/tháng, ví dụ: 2025/04. Quyền của các thư mục con cũng là 755.

Sau khi tạo xong, kiểm tra lại tính năng upload trong Media Library. Nếu vẫn lỗi, tiếp tục bước 3.

Bước 3: Kiểm tra và sửa quyền truy cập (permissions)

Quyền truy cập không đúng là nguyên nhân hàng đầu. Bạn cần đảm bảo:

• Thư mục /wp-content/uploads/ có quyền 755 (rwxr-xr-x) – chủ sở hữu có quyền đọc/ghi/thực thi, nhóm và others chỉ đọc/thực thi.
• Các file bên trong thư mục uploads nên có quyền 644 (rw-r–r–).
• Trong cPanel,

  Lỗi này chỉ ngăn bạn tải lên file mới. Nếu thư mục uploads bị xóa, tất cả dữ liệu cũ (ảnh, file) cũng biến mất. Nhưng nếu chỉ bị sai quyền hoặc cấu hình, dữ liệu cũ vẫn còn trên server. Hãy kiểm tra thật kỹ trước khi tạo lại thư mục.

  Tôi có thể khắc phục lỗi mà không cần FTP không?

  Có. Một số plugin như “Add From Server” hoặc “WP Media Folder” có thể bypass lỗi uploads bằng cách sử dụng đường dẫn tùy chỉnh. Tuy nhiên, giải pháp tốt nhất là sửa lỗi triệt để qua FTP hoặc File Manager của hosting. Nếu host cung cấp,

  Thường xuyên sao lưu website. Giữ quyền truy cập đúng tiêu chuẩn (755 cho thư mục, 644 cho file). Hạn chế cài plugin lạ can thiệp vào Media Library. Kiểm tra định kỳ đường dẫn uploads trong wp-config.php. Nếu dùng multisite, cần chú ý cấu trúc thư mục riêng.

  Lỗi này có liên quan đến bản cập nhật WordPress không?

  Rất hiếm. WordPress core thường không tự động thay đổi thư mục uploads. Nếu sau khi cập nhật site bị lỗi, rất có thể do xung đột plugin hoặc quyền bị thay đổi trong quá trình cập nhật. Hãy kiểm tra lại permissions.

  Khi nào nên liên hệ support hosting?

  Khi bạn đã thử tất cả các bước trên (tạo lại thư mục, sửa quyền, kiểm tra wp-config, vô hiệu hóa plugin) mà vẫn không khắc phục được, hãy liên hệ nhà cung cấp hosting. Họ có thể kiểm tra cấu hình server, disk space, hoặc lỗi trên PHP.

  Kết luận

  

  Lỗi “WordPress uploads directory missing” tuy gây phiền toái nhưng hoàn toàn có thể khắc phục bằng những bước đơn giản. Nguyên nhân chủ yếu là do thư mục uploads bị xóa hoặc quyền truy cập không đúng. Bằng cách kiểm tra FTP, tạo lại thư mục, thiết lập permissions 755, và loại trừ xung đột từ plugin/theme, bạn có thể đưa Media Library trở lại hoạt động bình thường trong vòng vài phút.

  Hãy luôn sao lưu dữ liệu trước khi can thiệp sâu vào hệ thống. Nếu gặp khó khăn, đừng ngần ngại nhờ đến sự hỗ trợ từ chuyên gia hoặc đội ngũ hosting của bạn. Với kiến thức trong bài viết này, bạn đã có đủ công cụ để tự mình giải quyết vấn đề và duy trì website WordPress ổn định.