Khắc phục lỗi WordPress AVIF upload: Nguyên nhân và giải pháp triệt để

Định dạng ảnh AVIF được giới thiệu như một cuộc cách mạng về tốc độ và dung lượng, nhưng không ít người dùng WordPress gặp phải tình trạng WordPress AVIF upload lỗi ngay khi vừa triển khai. Lỗi này thường biểu hiện dưới dạng thông báo “Không thể tải tệp lên” hoặc ảnh hiển thị hỏng, thậm chí có trường hợp ảnh tải lên nhưng không hiển thị trong thư viện. Bài viết này sẽ đi sâu vào từng nguyên nhân kỹ thuật, đưa ra các giải pháp kiểm tra và khắc phục dứt điểm, giúp bạn tận dụng tối đa lợi thế của AVIF trên nền tảng WordPress.

AVIF là gì và vì sao WordPress gặp lỗi khi upload?

AVIF (AV1 Image File Format) là định dạng ảnh thế hệ mới dựa trên codec video AV1, cho phép nén ảnh với chất lượng cao hơn JPEG tới 50% và hỗ trợ HDR, độ sâu màu 10-bit. Từ WordPress 5.8, hệ thống đã có hỗ trợ cơ bản cho AVIF, nhưng thực tế triển khai vẫn gặp nhiều rào cản do môi trường hosting, cấu hình PHP và thư viện GD/Imagick.

Khi bạn upload một tệp.avif lên WordPress, quá trình xử lý bao gồm: kiểm tra loại tệp, tạo thumbnail, nén và lưu trữ. Nếu bất kỳ bước nào gặp vấn đề, lỗi upload sẽ xuất hiện. Các nguyên nhân phổ biến bao gồm: thiếu thư viện hỗ trợ AVIF trên server, giới hạn dung lượng tệp, plugin bảo mật chặn, hoặc cấu hình.htaccess không cho phép.

Nguyên nhân phổ biến gây lỗi upload AVIF trong WordPress

1. Server thiếu thư viện GD hoặc Imagick hỗ trợ AVIF

WordPress sử dụng thư viện GD hoặc Imagick để xử lý ảnh. Để encode/decode AVIF, PHP cần được biên dịch với flag --with-avif (đối với GD) hoặc Imagick cần cài đặt delegate AVIF. Nếu hosting của bạn không đáp ứng, WordPress sẽ từ chối tải tệp. Theo thống kê, hơn 60% lỗi AVIF bắt nguồn từ nguyên nhân này.

• Kiểm tra bằng cách tạo file PHP với phpinfo() và tìm mục “GD Support” hoặc “imagick”, xem có dòng “AVIF Support” hay không.
• Với Shared hosting, bạn cần liên hệ nhà cung cấp yêu cầu kích hoạt. VPS hoặc Dedicated có thể tự biên dịch lại PHP.

2. Plugin bảo mật hoặc tối ưu ảnh chặn AVIF

Một số plugin như Wordfence, iThemes Security, hoặc các plugin tối ưu ảnh (Smush, ShortPixel, Imagify) có thể đưa AVIF vào danh sách đen do chưa cập nhật danh sách định dạng cho phép. Đặc biệt, các plugin nén ảnh thường chỉ hỗ trợ JPEG, PNG, WebP – khi gặp AVIF, chúng sẽ bỏ qua hoặc gây lỗi trong quá trình xử lý hàng loạt.

Giải pháp: Tạm thời vô hiệu hóa plugin bảo mật và tối ưu ảnh, sau đó thử upload lại. Nếu thành công, hãy cập nhật plugin lên phiên bản mới nhất hoặc thêm AVIF vào danh sách loại tệp được phép trong cài đặt plugin.

3. Giới hạn dung lượng upload tệp tin (upload_max_filesize)

Ảnh AVIF thường nhẹ hơn JPEG nhưng vẫn có thể vượt quá giới hạn mặc định nếu ảnh gốc có độ phân giải cao. WordPress có ba giới hạn: upload_max_filesize, post_max_size và max_execution_time trong php.ini. Nếu bất kỳ giá trị nào quá nhỏ, quá trình upload sẽ bị gián đoạn.

Thông số	Giá trị đề xuất	Vị trí cấu hình
upload_max_filesize	64M hoặc cao hơn	php.ini /.htaccess
post_max_size	64M hoặc cao hơn	php.ini /.htaccess
max_execution_time	300 giây	php.ini /.htaccess
max_input_time	300 giây	php.ini

4. WordPress chưa nhận diện đúng MIME type của AVIF

WordPress duy trì danh sách các loại tệp được phép upload trong hàm get_allowed_mime_types(). Mặc dù từ phiên bản 5.8 đã thêm AVIF, nhưng một số theme hoặc plugin có thể ghi đè danh sách này. Hậu quả là hệ thống báo “Loại tệp không được phép vì lý do bảo mật”.

Cách kiểm tra: Thêm dòng sau vào file functions.php của theme child:

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

Các giải pháp chi tiết khắc phục lỗi WordPress AVIF upload

Kiểm tra và kích hoạt hỗ trợ AVIF trên server

Đầu tiên, bạn cần xác định PHP đang dùng thư viện nào. Truy cập Tools > Site Health > Info, tìm mục “Server”. Nếu dùng PHP 8.0 trở lên, GD thường được cài sẵn nhưng cần flag AVIF. Với Imagick, hãy kiểm tra qua lệnh convert -version trong terminal. Nếu không có dòng “avif”, bạn cần cài đặt thêm libavif-dev và biên dịch lại.

Trên hầu hết các VPS Ubuntu, php phpinfo();?>. Tìm mục “gd” hoặc “imagick”. Nếu không thấy “AVIF Support”, bạn cần nâng cấp server.

Bước 3: Vô hiệu hóa tất cả plugin (trừ plugin cần thiết). Thử upload ảnh AVIF. Nếu thành công, kích hoạt từng plugin để xác định plugin gây lỗi.

Bước 4: Kích hoạt theme mặc định (Twenty Twenty-Four). Nếu upload thành công, lỗi do theme của bạn. Hãy liên hệ nhà phát triển theme hoặc thêm MIME type vào functions.php.

Bước 5: Kiểm tra file.htaccess và php.ini. Thêm dòng tăng giới hạn upload nếu cần.

Bước 6: Cài plugin “Enable AVIF Upload” hoặc “WebP & AVIF Uploader” để tự động hóa quy trình.

Câu hỏi thường gặp về lỗi upload AVIF trên WordPress

Tại sao tôi upload ảnh AVIF nhưng không hiển thị trong thư viện?

Có hai khả năng: hoặc server chưa hỗ trợ AVIF (ảnh không được tạo thumbnail), hoặc plugin bảo mật chặn hiển thị. Hãy kiểm tra thư mục wp-content/uploads để xem file có tồn tại không. Nếu có nhưng không hiển thị, hãy xóa cache và tải lại trang thư viện.

Lỗi “HTTP error” khi upload AVIF có nghĩa là gì?

Thông báo “HTTP error” thường liên quan đến giới hạn xử lý ảnh. Nguyên nhân do max_execution_time quá thấp hoặc dung lượng ảnh vượt upload_max_filesize.

Không bắt buộc. AVIF mang lại lợi ích về tốc độ, nhưng nếu bạn đang gặp lỗi upload, hãy ưu tiên khắc phục trước.

Bạn có thể sử dụng plugin “WebP & AVIF Uploader” cho phép upload AVIF dưới dạng file binary, hoặc sử dụng dịch vụ CDN có hỗ trợ chuyển đổi định dạng tự động (như Cloudflare Polish). Tuy nhiên, giải pháp lâu dài vẫn là cấu hình server đúng chuẩn.

Kết luận

Lỗi WordPress AVIF upload không phải là vấn đề khó xử lý nếu bạn nắm rõ các nguyên nhân kỹ thuật. Từ việc thiếu thư viện server, xung đột MIME type, đến giới hạn dung lượng đều có giải pháp cụ thể. Quan trọng nhất là bạn cần kiểm tra môi trường hosting trước tiên, sau đó mới can thiệp vào code hoặc plugin. Với hướng dẫn chi tiết ở trên, hy vọng bạn có thể tận dụng được định dạng ảnh AVIF để cải thiện tốc độ tải trang và trải nghiệm người dùng. Hãy luôn nhớ backup dữ liệu trước mọi thay đổi và kiểm tra kỹ từng bước để tránh phát sinh lỗi không mong muốn.