HeadRandom
Back to Main Site

Hướng dẫn khắc phục các lỗi thường gặp trong PolyCMS

Last updated on Jul 10, 2026 4:18 AM

Lỗi 404 khi truy cập các trang ngoài giao diện (Frontend 404)

Triệu chứng: Các trang ngoài blog trả về lỗi 404 "Page Not Found".

Giải pháp xử lý:

  1. Di chuyển đến mục Blog > Settings > Permalinks.
  2. Nhấp chọn Save Settings (ngay cả khi bạn không thay đổi thông số nào).
  3. Thao tác này giúp hệ thống tạo lại tệp tin cache định tuyến .blog_prefix_cache.php.
  4. Xóa bộ nhớ đệm trình duyệt và truy cập lại trang ngoài.

Nếu sự cố vẫn tiếp diễn, bạn hãy kiểm tra xem dịch vụ web server của mình đã kích hoạt mod_rewrite (đối với Apache) hoặc đã cấu hình đúng quy tắc try_files (đối với Nginx) chưa.

Lỗi từ chối quyền truy cập (Permission Denied)

Triệu chứng: Nhân viên không thể truy cập các tính năng quản trị của blog và nhận được thông báo "Permission Denied".

Giải pháp xử lý:

  1. Di chuyển đến mục Setup > Staff > [Chọn Nhân viên] > Permissions.
  2. Kích hoạt quyền polycms đi kèm các phân quyền tương ứng:
  • View — Duyệt xem bài viết, trang tĩnh, thư viện phương tiện và màn hình dashboard.
  • Create — Thêm mới các nội dung.
  • Edit — Chỉnh sửa bài viết, thay đổi trạng thái ẩn/hiện.
  • Delete — Xóa bỏ vĩnh viễn bài viết.
  1. Lưu ý: Các tài khoản có quyền Administrator mặc định sở hữu toàn quyền quản trị CMS mà không cần thiết lập mục này.

Lỗi tải tệp phương tiện thất bại (Upload Failures)

Triệu chứng: Thao tác tải hình ảnh lên thư viện báo lỗi hoặc không thực hiện được.

Nguyên nhân và hướng xử lý:

Nguyên nhân phát sinhGiải pháp khắc phục
Dung lượng tệp quá lớnTăng các thông số cấu hình PHP upload_max_filesize và post_max_size trong tệp php.ini của máy chủ
Định dạng tệp không được hỗ trợPolyCMS chỉ chấp nhận tải lên các định dạng: jpg, png, gif, webp, svg, pdf. Các định dạng tệp khác sẽ bị chặn
Thư mục lưu trữ không cho phép ghiĐảm bảo thư mục uploads/polycms/ trên máy chủ đã được cấp quyền ghi (chmod 755 hoặc 775)
Hàm PHP bị máy chủ khóaXác thực hàm move_uploaded_file không nằm trong danh sách disable_functions của cấu hình PHP

Lỗi giao diện hiển thị không chính xác (Broken Theme)

Triệu chứng: Giao diện trang ngoài blog bị vỡ bố cục, mất định dạng CSS hoặc hiển thị mã HTML thuần.

Giải pháp xử lý:

  1. Đảm bảo theme tương ứng đã được kích hoạt thành công trong mục Blog > Themes.
  2. Kiểm tra xem các tệp tin trong thư mục theme đã được tải lên đầy đủ chưa — đối chiếu lại với gói cài đặt theme gốc.
  3. Xóa các bộ nhớ đệm cache trên máy chủ (như OPcache, Varnish...).
  4. Nhấn F12 kiểm tra xem bảng console của trình duyệt có báo lỗi JavaScript hay lỗi tải tệp tin assets nào không.

Xung đột Plugin (Plugin Conflicts)

Triệu chứng: Kích hoạt một plugin mới làm phát sinh lỗi hệ thống hoặc làm treo các tính năng khác.

Giải pháp xử lý:

  1. Tạm tắt plugin vừa bật tại mục Blog > Plugins.
  2. Nếu không thể truy cập giao diện admin, bạn có thể kết nối FTP vào thư mục modules/polycms/plugins/ và đổi tên thư mục của plugin đó để tạm khóa nó.
  3. Gửi mô tả sự cố kèm mã lỗi chi tiết đến trang hỗ trợ Envato của chúng tôi để được hỗ trợ kiểm tra lỗi.

Bình luận không hiển thị ngoài trang chủ

Triệu chứng: Độc giả gửi bình luận thành công nhưng bình luận không hiển thị ở dưới bài viết.

Nguyên nhân có thể:

  • Bình luận đang chờ phê duyệt — bạn cần truy cập Blog > Comments để duyệt bình luận.
  • Tính năng bình luận bị tắt riêng trên bài viết đó — hãy mở chỉnh sửa bài viết tương ứng và tích chọn vào ô "Allow Comments".
  • Tính năng bình luận bị tắt trên toàn hệ thống — kiểm tra cấu hình tại Blog > Settings.

Tải trang chậm

Triệu chứng: Các trang ngoài blog mất nhiều thời gian để tải xong.

Giải pháp xử lý:

  1. Kích hoạt plugin MTOptimize để nén tối ưu hóa các tệp tin assets và hình ảnh.
  2. Kích hoạt các bộ nhớ đệm cache phía máy chủ (như OPcache cho PHP).
  3. Thực hiện nén dung lượng hình ảnh trước khi tải lên (ưu tiên sử dụng WebP hoặc JPEG đã được tối ưu).
  4. Đảm bảo các chỉ mục database hoạt động tốt bằng cách chạy lại tiến trình di chuyển dữ liệu (migrations).

Gặp lỗi database sau khi chuyển máy chủ

Triệu chứng: Các tính năng của CMS báo lỗi truy vấn cơ sở dữ liệu sau khi bạn thực hiện chuyển dữ liệu sang hosting/vps mới.

Giải pháp xử lý:

  1. Đảm bảo kết nối database của Perfex CRM hoạt động tốt (các tính năng khác của CRM chạy bình thường).
  2. Di chuyển đến mục Setup > Modules và xác nhận PolyCMS đã được kích hoạt.
  3. Nếu bị mất bảng dữ liệu, hãy tạm tắt và kích hoạt lại mô-đun để kích hoạt tệp tin cài đặt install.php khởi tạo lại các bảng cần thiết.

Liên hệ hỗ trợ kỹ thuật

Nếu bạn gặp phải các lỗi kỹ thuật khác chưa được đề cập ở trên, hãy liên hệ với chúng tôi qua trang tác giả PolyXGO trên CodeCanyon. Chúng tôi cung cấp dịch vụ hỗ trợ kỹ thuật hoàn toàn miễn phí cho toàn bộ khách hàng mua mô-đun.

Tài liệu hướng dẫn liên quan