TSF – Giải pháp IT toàn diện cho doanh nghiệp SMB | HCM

Trang chủ
Về chúng tôi
Giải pháp
Khóa học
Liên hệ
Youtube
  • English
  • Tiếng Việt
    • Contact

    P3 - Sửa Lỗi 404 XAMPP SnipeIT Và Cấu Hình Auto Start Trên Windows

    🚀 SnipeIT – P3 Hướng Dẫn Hoàn Chỉnh: Fix Lỗi 404 và Cấu Hình XAMPP Auto Start Services trên Windows

    Nếu bạn đang gặp lỗi 404 Not Found khi chạy Snipe-IT trên XAMPP, đây là một trong những lỗi phổ biến nhất khi triển khai ứng dụng Laravel trên môi trường Windows. Nguyên nhân thường đến từ việc cấu hình sai VirtualHost, chưa bật mod_rewrite, sai đường dẫn DocumentRoot hoặc cấu hình .env không khớp.

    Trong bài hướng dẫn chi tiết này, bạn sẽ được hướng dẫn cách fix lỗi 404 trên XAMPP, cấu hình chính xác Apache VirtualHost, chỉnh sửa file .htaccess, cập nhật .env và clear cache Laravel để hệ thống hoạt động ổn định.

    Ngoài ra, bạn cũng sẽ biết cách đảm bảo dịch vụ XAMPP hoạt động ổn định và sẵn sàng mỗi khi khởi động Windows, giúp môi trường lab/dev luôn hoạt động mà không cần thao tác thủ công.

    Bài viết phù hợp cho IT Support, System Administrator, Developer và sinh viên IT đang triển khai Snipe-IT trên Windows.

    🔍 Vì Sao Xảy Ra Lỗi 404 Trên XAMPP?

    Trước khi xử lý, cần hiểu các nguyên nhân phổ biến:

    • DocumentRoot trỏ sai thư mục

    • Chưa bật hoặc cấu hình sai mod_rewrite

    • File .htaccess không đúng

    • APP_URL trong .env không khớp với VirtualHost

    • Laravel đang cache cấu hình cũ

    Dưới đây là cách xử lý chi tiết.

    🛠️ Step 1: Cấu Hình VirtualHost Chính Xác

    Đây là bước quan trọng nhất để fix lỗi 404.

    Mở file:

     
    C:\xampp\apache\conf\extra\httpd-vhosts.conf

    Thêm hoặc chỉnh nội dung như sau:

     
     
    💻
    filename.bash 
    <VirtualHost *:80>
ServerName 192.168.16.134
DocumentRoot "C:/xampp/htdocs/snipe-it/public"

<Directory "C:/xampp/htdocs/snipe-it/public">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>

ErrorLog "logs/snipeit-error.log"
CustomLog "logs/snipeit-access.log" common
</VirtualHost>

    ⚠️ Lưu ý quan trọng:

    • DocumentRoot phải trỏ đến thư mục /public

    • AllowOverride All bắt buộc để .htaccess hoạt động

    • Lưu file sau khi chỉnh sửa

    🔄 Step 2: Chỉnh Sửa File .htaccess Trong Thư Mục Public

    Tiếp theo kiểm tra file .htaccess.

    Vị trí file:

     
    C:\xampp\htdocs\snipe-it\public\.htaccess

    Đảm bảo nội dung đúng như sau:

    💻
    filename.bash 
    <IfModule mod_rewrite.c>
<IfModule mod_negotiation.c>
Options -MultiViews -Indexes
</IfModule>

RewriteEngine On
RewriteBase /

# Redirect Trailing Slashes...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)/$ /$1 [L,R=301]

# Handle Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
</IfModule>

    Cấu hình này đảm bảo Laravel routing hoạt động chính xác và tránh lỗi 404 khi truy cập route.

    ⚙️ Step 3: Cập Nhật File .env Của Snipe-IT

    Mở file:

     
    C:\xampp\htdocs\snipe-it\.env

    Chỉnh sửa dòng:

     
    APP_URL=http://192.168.16.134

    Đảm bảo:

    • IP trùng với ServerName trong VirtualHost

    • URL truy cập khớp hoàn toàn

    Nếu không đồng bộ, Laravel sẽ sinh đường dẫn sai và gây lỗi 404.

    🔁 Step 4: Restart Service và Clear Cache

    Sau khi chỉnh cấu hình, cần xóa cache Laravel.

    Mở CMD và chạy:

     
    cd C:\xampp\htdocs\snipe-it
    php artisan config:clear
    php artisan cache:clear
    php artisan route:clear
     

    Các lệnh này sẽ:

    • Xóa cache cấu hình

    • Xóa cache ứng dụng

    • Xóa cache route

    Sau đó:

    • Restart Apache trong XAMPP

    • Stop → Start

    Kiểm tra lại truy cập Snipe-IT.

    ⚡ Mẹo Tăng Độ Ổn Định

    Để tránh lỗi lặp lại:

    ✔ Luôn trỏ DocumentRoot về /public
    ✔ Đồng bộ APP_URL với ServerName
    ✔ Clear cache sau khi thay đổi cấu hình
    ✔ Kiểm tra port 80 không bị service khác chiếm
    ✔ Kích hoạt Apache/MySQL dưới dạng service nếu cần

    Bạn có thể cấu hình Apache và MySQL chạy tự động cùng Windows bằng cách cài đặt dưới dạng Windows Service trong XAMPP Control Panel. Điều này giúp môi trường dev luôn sẵn sàng khi máy khởi động.

    🎯 Kết Quả Sau Khi Hoàn Thành

    Sau khi thực hiện đầy đủ:

    • Lỗi 404 sẽ được xử lý hoàn toàn

    • Laravel routing hoạt động đúng

    • VirtualHost cấu hình chính xác

    • Snipe-IT truy cập ổn định

    • Môi trường XAMPP trên Windows tối ưu hơn

    Phương pháp này áp dụng cho tất cả ứng dụng Laravel chạy trên XAMPP, không riêng Snipe-IT.

    🔥 Kết Luận

    Fix lỗi 404 trên XAMPP khi chạy Snipe-IT không quá phức tạp nếu bạn cấu hình đúng VirtualHost, .htaccess và đồng bộ .env. Sau khi clear cache và restart service, hệ thống sẽ hoạt động ổn định mà không còn lỗi route.

    Tham khảo thêm bài viết cùng chủ đề

    P12 – Hướng dẫn Check in SnipeIT Hàng Loạt Cực Nhanh

    P12 – Hướng dẫn Check in SnipeIT Hàng Loạt Cực Nhanh SnipeIT – P12 Cách Check-In & Check-Out Hàng Loạt Trong Snipe-IT (Bulk Method) Khi quản lý vài thiết bị, thao tác thủ công không phải vấn đề lớn. Nhưng khi cần xử lý 100–500 tài sản cùng lúc (onboarding,...

    Read More

    P11 – Hướng dẫn Check in SnipeIT cho IT Admins

    P11 – Hướng dẫn Check in SnipeIT cho IT Admins SnipeIT – P11 How to Manage Check In Check Out in SnipeIT (Step-by-Step) Trong quản lý tài sản CNTT, việc cập nhật trạng thái thiết bị chính xác là yếu tố sống còn. Nếu không thực hiện đúng quy trình...

    Read More