Estás con tu proyecto en XAMPP, abres localhost y ¡pum! Error 404. No es el fin del mundo, pero sí un fastidio que te corta el rollo. Aquí no vengo con teoría de manual: te cuento lo que de verdad falla y cómo arreglarlo en dos patadas.
Qué narices significa el 404 en XAMPP
El error 404 en XAMPP es la forma que tiene Apache de decirte: “tío, la ruta que pides no existe en mi cabeza”. No es que el servidor esté roto, es que no encuentra el archivo o la carpeta que le estás pidiendo. Traducido: tú escribes una URL y Apache mira en htdocs y no ve nada con esa pinta.
La mayoría de las veces es culpa de una ruta mal puesta, un .htaccess travieso o un servicio que ni siquiera está levantado. Vamos por partes.
1. Revisa la ruta dentro de htdocs (el 90% de los casos)
Si tu proyecto está en C:/xampp/htdocs/mi-proyecto, la URL NO es http://localhost/mi-proyecto a secas si dentro hay subcarpetas. Y ojo con las mayúsculas: en Windows da igual, pero si luego subes a Linux, Mi-Proyecto y mi-proyecto son cosas distintas. Apache en Linux es sensible a mayúsculas y eso te revienta el 404 en XAMPP sin que te des cuenta.
Comprueba también que no tengas el archivo dentro de una carpeta extra. A veces copias el proyecto y queda htdocs/mi-proyecto/mi-proyecto/index.php. Ahí Apache se pierde y te suelta el 404.
2. Apache y MySQL: míralos, aunque te parezca obvio
Suena a broma, pero he visto a gente volverse loca con el error 404 en XAMPP porque Apache estaba en rojo y no se habían dado cuenta. Abre el panel de control y verifica que ambos módulos estén en verde.
Si Apache no arranca, el 404 es lo de menos: no hay servidor. Y si arranca pero MySQL no, tu web puede cargar a medias y lanzar errores raros que confundes con un 404.
3. El puerto 80 está ocupado (culpa de Skype, IIS o Docker)
Este es un clásico. Skype, IIS, algunos servicios de Docker o incluso el propio Windows con su “World Wide Web Publishing Service” chupan el puerto 80. Apache no puede escuchar y, aunque a veces arranca, las peticiones se van a otro sitio y aparece el 404 not found en XAMPP.
Solución rápida: cambia el puerto en httpd.conf. Busca Listen 80 y pon Listen 8080. Luego accede con http://localhost:8080/mi-proyecto/. Y no olvides cambiar también ServerName localhost:8080.
Puedes ver qué proceso ocupa el puerto con netstat -ano | findstr :80 en Windows. Si sale un PID, lo matas desde el Administrador de tareas y listo.
4. El .htaccess y las reglas de reescritura
Si usas WordPress, Laravel o cualquier framework con URLs amigables, el .htaccess es el sospechoso habitual. Un RewriteBase mal puesto o un RewriteRule que no encaja y adiós muy buenas: Apache te devuelve el 404 en XAMPP.
Prueba a renombrar temporalmente el .htaccess a .htaccess.bak. Si la web carga, el problema está ahí. Revisa que el módulo mod_rewrite esté activado en httpd.conf (quita el # de la línea LoadModule rewrite_module modules/mod_rewrite.so).
5. Permisos de archivos y carpetas
En Windows esto rara vez pasa, pero si usas XAMPP en Linux o Mac, los permisos te pueden amargar. Apache necesita leer los archivos de htdocs. Si están con permisos 600 o pertenecen a root, el servidor no los ve y lanza un 404 como una casa.
Dale permisos 755 a carpetas y 644 a archivos. Y asegúrate de que el usuario de Apache (normalmente daemon o www-data) tenga acceso.
6. DocumentRoot mal configurado
Si has movido tu proyecto fuera de htdocs, tienes que tocar el DocumentRoot en httpd.conf. Si no lo haces, Apache sigue mirando en la carpeta por defecto y no encuentra nada. Cambia también el bloque para que apunte a la nueva ruta.
Ojo: si usas rutas con espacios o caracteres raros, ponlas entre comillas en el httpd.conf. Un espacio mal puesto y Apache se queda tonto.
7. Logs de Apache: tu mejor amigo cuando nada funciona
Si después de todo sigue el 404, abre xampp/apache/logs/error.log. Ahí Apache te dice exactamente qué archivo no encuentra y por qué. Muchas veces el mensaje es claro: “File does not exist: C:/xampp/htdocs/…”. Eso te ahorra media hora de prueba y error.
También revisa access.log para ver qué URL está pidiendo el navegador. A veces el problema es que tu propio código genera un enlace mal formado.
8. Virtual hosts: si usas varios proyectos
Si tienes configurados virtual hosts en httpd-vhosts.conf, un ServerName mal escrito o un DocumentRoot que no existe te tira el 404 en XAMPP. Verifica que el archivo hosts de Windows (C:WindowsSystem32driversetchosts) tenga la línea 127.0.0.1 mi-proyecto.local.
Y no te olvides de incluir el archivo de vhosts en httpd.conf: Include conf/extra/httpd-vhosts.conf.
9. Reinstalar XAMPP: el último recurso (pero a veces necesario)
Si has tocado configuraciones y ya no sabes ni lo que has cambiado, una instalación limpia de XAMPP te salva. Pero antes, haz copia de tus proyectos en htdocs y de tus bases de datos en mysql/data. Reinstalar sin backup es de novatos.
Muchas veces el error 404 en XAMPP viene de una instalación corrupta o de haber mezclado versiones. Una limpia y a correr.
10. Errores típicos que te hacen perder el tiempo
- Escribir localhost sin el puerto cuando has cambiado Apache a 8080.
- Usar https en local cuando XAMPP por defecto va por http. Si fuerzas https sin certificado, el navegador se queja y a veces parece un 404.
- Olvidar el index.php en la URL cuando no hay DirectoryIndex configurado para esa carpeta.
- Carpetas con nombres con acentos o ñ: Apache puede volverse loco con la codificación.
- Antivirus o firewall bloqueando Apache sin avisar. Revisa que no esté en cuarentena.
Al final, el 404 en XAMPP no es más que un aviso de que algo no cuadra entre lo que pides y lo que Apache encuentra. Con estos pasos, el 99% de las veces lo resuelves en menos de diez minutos. Y si no, siempre te queda el log para saber exactamente dónde está el fallo.
Así que respira, revisa rutas, puertos y permisos, y vuelve a darle caña a tu proyecto. El error 404 en XAMPP es solo un bache, no un muro.