Khắc phục sự cố và lỗi thường gặp trong PolyCMS cho RISE CRM
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:
- Đi tới PolyCMS > Permalinks (
/polycms/permalink-settings). - 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. - 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. - Xác nhận máy chủ web đã bật quy tắc viết lại URL:
mod_rewritecùngAllowOverride Alltrên Apache, hoặc cấu hìnhtry_files $uri $uri/ /index.php?$query_string;hợp lệ trên Nginx. - 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:
- Đăng nhập bằng tài khoản Quản trị viên RISE CRM và mở Settings > Access Permission > Roles.
- Chọn vai trò (Role) đang gán cho nhân sự và cuộn xuống mục phân quyền PolyCMS.
- 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.
- 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:
- 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). - Kiểm tra đầy đủ tệp nguồn của theme trong
plugins/polycms/themes/<theme-slug>/so với gói gốc. - Đi tới PolyCMS > Settings > Performance (
#tab-performance) và nhấn Clear Cache để xóa tệp HTML đệm cũ trongwritable/polycms/cache/. - Xóa bộ nhớ đệm máy chủ như PHP OPcache hoặc lớp proxy đệm (Cloudflare, Nginx FastCGI cache, Varnish).
- Mở Công cụ phát triển trình duyệt (tab Console và Network) để kiểm tra lỗi
404tà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:
- 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.
- 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ụ đổimy-pluginthànhmy-plugin.disabled). - 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:
- 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. - 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.
- 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).
- 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:
- 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.phpchính xác. - Đố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. - Đ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()trongplugins/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
- Hướng dẫn Cài đặt và Kích hoạt - Danh sách yêu cầu máy chủ và quy trình thiết lập chuẩn.
- Cài đặt Permalink và Đường dẫn URL - Quản lý tiền tố URL và làm mới bộ nhớ đệm định tuyến.
- Câu hỏi thường gặp về PolyCMS - Giải đáp nhanh về an toàn dữ liệu, cập nhật và độ tương thích.