Tài liệu hỗ trợ • Winora & subdomain tương tự

Chẩn đoán Laravel,
không còn mò mẫm.

Quy trình xử lý lỗi 500, Redis, đường dẫn public và quyền thư mục — những lệnh cần dùng khi website Laravel gặp sự cố trên hosting.

!

Trước khi bắt đầu

Luôn sao lưu các file quan trọng trước khi chỉnh sửa.

cp .env .env.backup

Lối tắt

Quy trình xử lý nhanh

10 bước
  1. 01Vào thư mục source
  2. 02Xóa cache Laravelphp artisan optimize:clear
  3. 03Xóa log cũ: > storage/logs/laravel.log
  4. 04Đọc lỗi mới nhấttail -n 120 storage/logs/laravel.log
Xem toàn bộ quy trình →

Laravel Artisan

Thư viện lệnh thường dùng

Chẩn đoán

Kiểm tra phiên bản PHP

php -v
Chẩn đoán

Kiểm tra syntax index.php

php -l public_html/index.php
Chẩn đoán

Liệt kê route

php artisan route:list
Chẩn đoán

Trạng thái migration

php artisan migrate:status
Cache

Xóa toàn bộ cache

php artisan optimize:clear
Cache

Xóa config cache

php artisan config:clear
Cache

Xóa route & view cache

php artisan route:clear
php artisan view:clear
Storage

Tạo storage symlink

php artisan storage:link
Production

Tạo config cache

php artisan config:cache
Production

Tạo view cache

php artisan view:cache
Production

Khởi động lại queue worker

php artisan queue:restart
Lưu ý hosting

Không chạy lệnh này

php artisan about

Có thể lỗi khi hosting tắt proc_open.

Smart triage

Bắt đầu từ triệu chứng

Chọn lỗi đang gặp để nhận thứ tự kiểm tra an toàn và lệnh chẩn đoán tương ứng.

Chọn triệu chứng để bắt đầu.

Support case workspace

Quản lý một ca xử lý lỗi

Lưu trạng thái công việc ngay trên trình duyệt. Dữ liệu `.env` và log không nằm trong phiên này.

Chưa lưu phiên.

Release gate

Đủ điều kiện mở lại website?

Nhập kết quả kiểm tra sau khi sửa/deploy. Gate không gửi request; nó chỉ đánh giá dữ liệu bạn đã xác minh.

Nhập các kết quả kiểm tra để đánh giá.

01

Chẩn đoán cơ bản

Xóa cache & lấy lỗi 500

Dọn cache trước khi sửa và chỉ đọc exception đầu tiên hoặc phần “previous exception” trong log.

php artisan optimize:clear
: > storage/logs/laravel.log
tail -n 120 storage/logs/laravel.log
! Không chạy php artisan about vì hosting có thể đã tắt proc_open.
02

Lỗi Redis / session

Kiểm tra cấu hình .env

Khi hosting không có Redis hoặc Redis không hoạt động, đưa các dịch vụ về file và sync.

SESSION_DRIVER=file
CACHE_STORE=file
QUEUE_CONNECTION=sync
mkdir -p storage/framework/cache/data storage/framework/sessions storage/framework/views
chmod -R 775 storage bootstrap/cache
03

Lỗi filemtime / asset

Laravel tìm /public thay vì /public_html

Nếu log báo không tìm được asset trong public, hãy tạo symbolic link đến thư mục public thật.

✓ Kết quả đúng: public -> public_html

      
04
Media không hiển thị
Kết nối thư mục ảnh storage
Để URL /storage/... hoạt động, public_html cần trỏ đến storage/app/public.
php artisan storage:link
Ghi chú: chạy lệnh tại thư mục source, rồi kiểm tra bằng ls -ld public_html/storage. Kết quả cần là public_html/storage -> ../storage/app/public.
✓ Chỉ tạo link khi public_html/storage chưa tồn tại; không ghi đè thư mục hiện có.

      
05
Phân quyền an toàn
Quyền file & thư mục
Tránh đặt toàn bộ source thành 777. Chỉ cấp quyền ghi cho các vùng Laravel cần thiết.
755Thư mục thông thường
644File thông thường
775storage, cache, uploads

      
06
Sau khi website ổn định
Bật lại cache production
Chỉ chạy khi website hoạt động bình thường. Nếu route cache lỗi do Closure, hãy bỏ qua lệnh đó.
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

    

    
Công cụ chẩn đoán
Phân tích file ngay trên trình duyệt
Nội dung bạn dán hoặc tải lên chỉ được xử lý trên thiết bị này.
01
.env & Security Analyzer
Kiểm tra cấu hình production, Redis và cookie bảo mật.
02
Laravel Log Analyzer
Tìm exception gốc và dòng lỗi cần chú ý.
03
SSH Runbook Builder
Tạo bộ lệnh theo đúng tình huống, có thể sao chép hoặc xuất thành file .txt.
Nhập domain để tạo bộ lệnh.

    
04 → 08 • Operations toolkit
Kiểm tra, triển khai và khôi phục
Chọn từng công cụ theo thứ tự xử lý. Các lệnh luôn dùng domain đã thiết lập.

      
04
Database & PHP Advisor
Kiểm tra nhanh cặp phiên bản PHP/Laravel và tạo lệnh database.

      
04B
Permission Scanner
Dán kết quả ls -la để phát hiện quyền 777 hoặc .env quá mở.

      
05
.htaccess Inspector
Dán hoặc tải file để kiểm tra rewrite, HTTPS và chặn file nhạy cảm.

      
06
Composer Inspector
Đọc composer.json, phát hiện debug package và kiểm tra PHP requirement.

      
07
Security Headers Audit
Dán response headers từ curl -ksSI https://domain/.

      
08
Deploy, Queue & Recovery
Bộ lệnh theo quy trình: maintenance → deploy → health check hoặc rollback an toàn.

      
09
Incident Report
Tạo báo cáo xử lý sự cố để gửi khách hàng hoặc team kỹ thuật.