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:

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:

Đả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:

Chỉnh sửa dòng:

Đả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:

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ủ đề

P13 – Professional Tạo Mã QR Cho Asset SnipeIT Cực Dễ

P13 – Professional Tạo Mã QR Cho Asset SnipeIT Cực Dễ SnipeIT – P13 Hướng Dẫn Tạo Mã QR Cho Asset Và In Tem QR Code Trong môi trường doanh nghiệp, việc quản lý tài sản IT nếu không có nhãn định danh rõ ràng sẽ rất dễ gây nhầm...

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,...

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...