Back to Main Site

Khắc phục sự cố và lỗi thường gặp trong PolyCMS cho RISE CRM

Last updated on Nov 22, 2026 7:37 AM 7:37 AM 2,084.79 ms

Hướng dẫn này giúp quản trị viên RISE CRM chẩn đoán và xử lý nhanh những sự cố phổ biến nhất khi vận hành PolyCMS, bao gồm lỗi 404 ngoài giao diện công khai, thiếu quyền truy cập theo vai trò, lỗi tải tệp media và ghi cache, xung đột sub-plugin, hiển thị theme và lỗi cơ sở dữ liệu sau khi di chuyển máy chủ. Hãy thực hiện lần lượt từng bước kiểm tra tương ứng để khôi phục hệ thống an toàn mà không mất dữ liệu.

Lỗi 404 trên các trang công khai (Frontend)

Biểu hiện: Bài viết blog, trang chuyên mục hoặc trang tĩnh CMS trả về lỗi 404 Page Not Found.

Cách khắc phục:

  1. Đi tới PolyCMS > Permalinks (/polycms/permalink-settings).
  2. Nhấn Save Settings ngay cả khi bạn không thay đổi thông số nào. Thao tác này sẽ tái tạo tệp bộ nhớ đệm định tuyến tại files/polycms/.blog_prefix_cache.php.
  3. Kiểm tra thư mục files/polycms/ có quyền ghi cho tài khoản máy chủ web để tệp .blog_prefix_cache.php được cập nhật thành công.
  4. Xác nhận máy chủ web đã bật quy tắc viết lại URL: mod_rewrite cùng AllowOverride All trên Apache, hoặc cấu hình try_files $uri $uri/ /index.php?$query_string; hợp lệ trên Nginx.
  5. Xóa bộ nhớ đệm trình duyệt và tải lại đường dẫn trang công khai.

Lỗi từ chối quyền truy cập hoặc ẩn menu PolyCMS

Biểu hiện: Nhân sự không nhìn thấy nhóm menu PolyCMS hay Appearance, hoặc gặp thông báo từ chối truy cập khi mở màn hình CMS.

Cách khắc phục:

  1. Đăng nhập bằng tài khoản Quản trị viên RISE CRM và mở Settings > Access Permission > Roles.
  2. Chọn vai trò (Role) đang gán cho nhân sự và cuộn xuống mục phân quyền PolyCMS.
  3. Cấp 5 nhóm quyền chi tiết phù hợp với nhiệm vụ:
    • polycms_view (PolyCMS: View) - Xem Dashboard, bài viết, trang tĩnh, chuyên mục, thẻ tag, bình luận và thư viện media.
    • polycms_create (PolyCMS: Create) - Tạo mới bài viết, trang tĩnh và mục phân loại.
    • polycms_edit (PolyCMS: Edit) - Chỉnh sửa nội dung, xuất bản/gỡ xuất bản và kiểm duyệt bình luận.
    • polycms_delete (PolyCMS: Delete) - Xóa vĩnh viễn nội dung CMS và tệp media.
    • polycms_settings (PolyCMS: Settings) - Quản lý Settings, Permalinks, Plugins, Themes và Tools của PolyCMS.
  4. Nhấn Save và yêu cầu nhân sự tải lại RISE CRM.

Tài khoản Quản trị viên RISE và các vai trò có quyền can_manage_all_kinds_of_settings mặc định sở hữu toàn quyền PolyCMS mà không cần bật thủ công.

Lỗi tải tệp Media và lỗi ghi thư mục bộ nhớ đệm

Biểu hiện: Tải ảnh lên tại PolyCMS > Media thất bại, hoặc tính năng cache HTML, sao lưu SQL và HTMLPurifier báo không thể ghi tệp.

Nguyên nhân và cách xử lý:

Nguyên nhân Giải pháp
Thư mục chưa có quyền ghi Đảm bảo cả hai thư mục files/polycms/ và writable/polycms/ (gồm cache/, rate_limit/, backups/, htmlpurifier/) đều tồn tại và có quyền ghi (755 hoặc 775, đúng chủ sở hữu máy chủ web).
Dung lượng tệp vượt giới hạn PHP Tăng thông số upload_max_filesize và post_max_size trong php.ini, sau đó khởi động lại PHP-FPM hoặc Apache.
Định dạng tệp không được hỗ trợ PolyCMS chỉ cho phép các định dạng an toàn (jpg, jpeg, png, gif, webp, svg, pdf). Hãy chuyển đổi tệp trước khi tải lên.
Hàm tải tệp PHP bị vô hiệu hóa Kiểm tra hàm move_uploaded_file và tiện ích mở rộng PHP fileinfo đang được bật trong cấu hình PHP 8.1+.

Giao diện Theme hiển thị sai hoặc vỡ bố cục

Biểu hiện: Trang công khai mất CSS, thiếu thành phần giao diện hoặc hiển thị bố cục cũ.

Cách khắc phục:

  1. Mở Appearance > Themes (/polycms/themes) và xác nhận đang có một theme được kích hoạt (chẳng hạn Head Random).
  2. Kiểm tra đầy đủ tệp nguồn của theme trong plugins/polycms/themes/<theme-slug>/ so với gói gốc.
  3. Đi tới PolyCMS > Settings > Performance (#tab-performance) và nhấn Clear Cache để xóa tệp HTML đệm cũ trong writable/polycms/cache/.
  4. Xóa bộ nhớ đệm máy chủ như PHP OPcache hoặc lớp proxy đệm (Cloudflare, Nginx FastCGI cache, Varnish).
  5. Mở Công cụ phát triển trình duyệt (tab Console và Network) để kiểm tra lỗi 404 tài nguyên tĩnh hoặc cảnh báo nội dung hỗn hợp (http:// và https://).

Xung đột Sub-Plugin hoặc lỗi PHP nghiêm trọng

Biểu hiện: Kích hoạt một sub-plugin tùy biến gây lỗi PHP hoặc khiến màn hình quản trị không phản hồi.

Cách khắc phục:

  1. Nếu vẫn vào được trang quản trị, đi tới PolyCMS > Plugins và nhấn Deactivate ở sub-plugin gây lỗi.
  2. Nếu không thể truy cập giao diện quản trị, kết nối FTP, SFTP hoặc SSH tới {rise_crm_root}/plugins/polycms/plugins/ và đổi tên tạm thư mục sub-plugin bị lỗi (ví dụ đổi my-plugin thành my-plugin.disabled).
  3. Tải lại RISE CRM, kiểm tra tệp nhật ký lỗi CodeIgniter 4 trong writable/logs/ để xác định nguyên nhân gốc trước khi kích hoạt lại.

Bình luận không hiển thị dưới bài viết

Biểu hiện: Độc giả gửi bình luận thành công nhưng nội dung chưa xuất hiện trên trang bài viết.

Danh sách kiểm tra:

  • Đang chờ duyệt: Mở PolyCMS > Comments và phê duyệt các bình luận ở trạng thái chờ.
  • Tắt riêng trên bài viết: Mở bài viết tại PolyCMS > Posts và đảm bảo tùy chọn cho phép bình luận đang bật.
  • Tắt trên toàn hệ thống: Kiểm tra cài đặt bật bình luận tại PolyCMS > Settings > General (#tab-general).
  • Trang đang lưu cache HTML: Nhấn xóa cache tại PolyCMS > Settings > Performance để bình luận vừa duyệt hiển thị ngay.

Tải trang công khai chậm

Biểu hiện: Trang chủ blog, trang danh mục hoặc trang chi tiết bài viết mất nhiều thời gian phản hồi.

Giải pháp tối ưu:

  1. Bật tính năng bộ nhớ đệm trang HTML tích hợp sẵn tại PolyCMS > Settings > Performance (writable/polycms/cache/) và thiết lập thời gian lưu cache phù hợp.
  2. Kích hoạt PHP OPcache trên máy chủ để mã PHP của CodeIgniter 4 và PolyCMS được thực thi từ bộ nhớ đệm mã máy.
  3. Nén hình ảnh trước khi tải lên (ưu tiên định dạng WebP hoặc JPEG tối ưu dung lượng).
  4. Rà soát các sub-plugin bên thứ ba hoặc đoạn mã nhúng ngoài có thể chặn quá trình tải trang.

Lỗi cơ sở dữ liệu sau khi di chuyển máy chủ

Biểu hiện: PolyCMS báo thiếu bảng SQL hoặc lỗi truy vấn sau khi chuyển RISE CRM sang máy chủ mới hoặc thay đổi tiền tố bảng.

Cách khắc phục:

  1. Kiểm tra các chức năng lõi của RISE CRM (Dashboard, Khách hàng, Hóa đơn) hoạt động bình thường để chắc chắn kết nối cơ sở dữ liệu trong .env / app/Config/Database.php chính xác.
  2. Đối chiếu đủ 19 bảng PolyCMS ({prefix}blog_*) đã được nhập đúng theo tiền tố bảng hiện tại của RISE CRM.
  3. Đi tới Settings > Plugins trong RISE CRM, tắt PolyCMS rồi kích hoạt lại. Quá trình kích hoạt lại sẽ chạy hàm polycms_install_schema() trong plugins/polycms/index.php để tự tạo bổ sung các bảng còn thiếu một cách an toàn mà không ghi đè bài viết hiện có.

Cần hỗ trợ thêm?

Nếu sự cố vẫn tiếp diễn sau khi kiểm tra các bước trên, hãy thu thập đoạn nhật ký lỗi trong writable/logs/ cùng phiên bản RISE CRM và phiên bản PHP, sau đó liên hệ với chúng tôi qua trang hỗ trợ PolyXGO trên CodeCanyon.

Tài liệu liên quan