Cómo saber si mi htaccess funciona: diagnóstico paso a paso

Saber cómo saber si mi htaccess funciona es la primera pregunta que debes responder antes de tocar una sola regla más. El archivo .htaccess es silencioso cuando falla: no lanza una alerta en tu panel de hosting ni te avisa por correo. Simplemente no hace nada, o hace algo inesperado. El problema puede estar en que Apache no lo lee, en que lo lee pero ignora tus directivas, o en que la sintaxis de una regla específica es incorrecta. Este artículo distingue los tres casos y te da el procedimiento exacto para cada uno.

Table of Contents

Entiende primero qué hace Apache con tu .htaccess

El archivo .htaccess es un fichero de configuración distribuida que Apache lee en cada petición HTTP, antes de servir cualquier recurso. No es un script ni un programa: es un listado de directivas que Apache interpreta en orden, de arriba a abajo. Cuando Apache encuentra el archivo, aplica sus reglas al directorio donde está y a todos sus subdirectorios.

La clave está en esa palabra: cuando. Apache solo lee el .htaccess si su configuración principal lo permite. La directiva AllowOverride en el archivo de configuración del servidor (generalmente httpd.conf o un virtualhost) decide si los archivos .htaccess tienen efecto o se ignoran por completo. Si está configurada como AllowOverride None, tu .htaccess existe pero Apache lo saltará sin decirte nada.

Esto explica el escenario más frustrante: has escrito reglas correctas, el archivo está en el sitio adecuado, y nada funciona. No es un error de sintaxis; es que el servidor ni siquiera ha mirado el archivo. El diagnóstico empieza aquí, antes de revisar una sola línea de tus reglas.

Un matiz importante: en entornos de hosting compartido no tienes acceso al httpd.conf. En ese caso, AllowOverride suele estar activado por defecto para los directorios de usuario, pero no siempre. Si tu proveedor usa un servidor diferente, como Nginx, el .htaccess directamente no existe: Nginx no lo lee. Las reglas equivalentes van en la configuración del virtualhost.

Verifica si Apache lee tu archivo con esta prueba de error deliberado

La forma más rápida y fiable de comprobar si Apache está leyendo tu .htaccess es provocar un error de sintaxis intencionado. Apache no ejecuta directivas inválidas y, si intenta leer el archivo, devolverá un error 500 (Internal Server Error) inmediatamente. Si no devuelve ese error, el archivo no se está leyendo.

  1. Abre tu .htaccess con el gestor de archivos de tu hosting o mediante FTP.
  2. Añade en la primera línea un texto sin sentido, como una palabra aleatoria: testfallo.
  3. Guarda el archivo.
  4. Recarga cualquier página de tu sitio en el navegador.
  5. Si ves un error 500, Apache está leyendo el archivo. Elimina la línea de prueba y guarda de nuevo.
  6. Si la página carga con normalidad, Apache ignora el archivo.

Imagina una web de servicios de fontanería en WordPress: el propietario añade reglas de redirección para las páginas antiguas, pero la web sigue mostrando las URLs viejas. Aplica esta prueba, la página carga sin error 500 y descubre que su proveedor tiene AllowOverride None en el virtualhost. La solución pasa por contactar al soporte del hosting para que activen el soporte de .htaccess, o por migrar a un plan que lo permita.

Un error habitual en este punto: confundir un error 500 preexistente con el provocado por la prueba. Antes de añadir la línea de prueba, comprueba que el sitio carga correctamente. Si ya tienes un 500 antes de tocar nada, el problema es otro.

Diagnostica si tus reglas específicas tienen efecto

Una vez confirmado que Apache lee el archivo, el siguiente nivel es verificar que una directiva concreta funciona. Aquí el método varía según el tipo de regla.

Comprueba redirecciones con las herramientas del navegador

Las redirecciones son las directivas más fáciles de verificar sin herramientas externas. Abre las DevTools de tu navegador (F12 en Chrome o Firefox), ve a la pestaña Network y activa la opción Preserve log. Después, escribe en la barra de direcciones la URL que debería redirigir y pulsa Enter. En el listado de peticiones verás la primera solicitud con un código 301 o 302 y la URL de destino en la cabecera Location. Si la primera petición devuelve 200 directamente, la redirección no está aplicándose.

Para un diagnóstico más limpio, usa una herramienta como Redirect Checker o la extensión Redirect Path para Chrome. Estas herramientas muestran toda la cadena de redirecciones, lo que es especialmente útil cuando tienes varias reglas que se encadenan y quieres ver exactamente dónde se rompe el flujo.

El error habitual aquí es el bucle de redirección: una regla que redirige de A a B y otra que redirige de B a A. El navegador te mostrará el mensaje ERR_TOO_MANY_REDIRECTS. Para localizarlo, comenta temporalmente las reglas (añade # al principio de cada línea) y actívalas de una en una hasta identificar cuál genera el bucle.

Verifica reglas de reescritura con el módulo mod_rewrite

Las reglas de reescritura (mod_rewrite) son más difíciles de depurar porque transforman las URLs internamente sin mostrar redirecciones visibles en el navegador. El módulo mod_rewrite es el componente de Apache que permite reescribir URLs dinámicamente según patrones y condiciones.

Si tienes acceso al servidor (un VPS o servidor dedicado), puedes activar el log de mod_rewrite añadiendo temporalmente estas líneas a tu .htaccess:

LogLevel alert rewrite:trace3

Esto escribe en el log de errores de Apache el razonamiento de cada regla: qué patrón evaluó, si coincidió y qué hizo. Revisa el archivo de log (error.log) después de hacer una petición a la URL problemática y busca las líneas con rewrite. Verás exactamente en qué paso falla la lógica.

En hosting compartido esto no siempre está disponible. En ese caso, usa htaccess.madewithlove.com, una herramienta gratuita que simula el motor de mod_rewrite en el navegador: introduces tus reglas y la URL de entrada, y te muestra si hay coincidencia y cuál sería el resultado.

Confirma cabeceras de seguridad y compresión

Directivas como Header set, AddOutputFilterByType o ExpiresActive modifican las cabeceras HTTP de las respuestas. Para verificarlas, usa curl desde la terminal:

curl -I https://tudominio.com/pagina

La opción -I solicita solo las cabeceras. Si tu .htaccess añade una cabecera X-Content-Type-Options o activa la compresión gzip, las verás en la respuesta. También puedes usar la pestaña Network de DevTools: haz clic sobre cualquier petición y revisa la sección Response Headers.

Localiza errores de sintaxis antes de que rompan tu sitio

Un .htaccess con un error de sintaxis no falla en silencio: provoca un error 500 en todas las páginas del directorio donde está. El problema es saber en qué línea está el error.

Si tienes acceso SSH al servidor, el comando más directo es:

apachectl configtest

Este comando valida la configuración de Apache, pero no siempre señala el .htaccess directamente. Una alternativa más específica es revisar el log de errores de Apache justo después de que aparezca el error 500. Busca la línea que contiene AH00526 o Invalid command: te indicará la directiva problemática y el número de línea.

El log de errores de Apache es el único testigo imparcial de lo que hace tu .htaccess. Si no lo consultas, estás diagnosticando a ciegas.

Sin acceso SSH, el procedimiento es más manual: comenta la mitad de las reglas (añade # delante de cada línea), recarga el sitio y comprueba si el error desaparece. Si desaparece, el error está en la mitad comentada. Repite el proceso dividiendo esa mitad hasta aislar la línea exacta. Es el método de bisección, el mismo que usan los desarrolladores para depurar cualquier configuración sin herramientas de log.

El error de sintaxis más común en .htaccess de WordPress es una directiva RewriteRule incompleta: le falta el tercer argumento (los flags entre corchetes) o tiene un espacio de más entre los elementos. También aparecen problemas con caracteres especiales copiados desde procesadores de texto que sustituyen las comillas rectas por tipográficas.

Diagnóstico avanzado: qué mirar cuando todo parece correcto pero no funciona

Este es el escenario más difícil: Apache lee el archivo, la sintaxis es válida y las reglas parecen bien escritas, pero el comportamiento esperado no se produce. Aquí entran en juego las condiciones del entorno.

Comprueba si mod_rewrite está habilitado

Que Apache lea el .htaccess no significa que todos los módulos estén activos. El módulo mod_rewrite debe estar cargado explícitamente en la configuración del servidor. Para verificarlo desde la terminal:

apache2ctl -M | grep rewrite

Si el comando devuelve rewrite_module (shared), el módulo está activo. Si no devuelve nada, el módulo no está cargado y todas tus directivas RewriteRule generarán errores 500 o se ignorarán según la versión de Apache.

En hosting compartido no puedes ejecutar este comando. La alternativa es crear un archivo PHP temporal con el contenido <?php phpinfo(); ?>, subirlo al servidor y abrirlo en el navegador. Busca la sección apache2handler o Apache Environment y dentro de ella la fila Loaded Modules. Si aparece mod_rewrite, está activo. Elimina ese archivo PHP en cuanto termines.

Revisa el orden de las reglas y la directiva RewriteBase

El orden de las reglas en .htaccess importa: Apache las evalúa secuencialmente y se detiene cuando encuentra una coincidencia, salvo que uses el flag [L] de forma incorrecta. Una regla que captura todas las peticiones antes de que lleguen a las específicas es un problema clásico.

La directiva RewriteBase es otro punto de fallo habitual. Indica la ruta base desde la que se resuelven las reescrituras relativas. Si tu WordPress está instalado en un subdirectorio (como /blog/) y no tienes RewriteBase /blog/, las reglas de reescritura buscarán los recursos desde la raíz del servidor y no encontrarán nada. El síntoma es un error 404 en páginas que deberían existir.

Imagina una tienda online instalada en https://ejemplo.com/tienda/: las páginas de categoría devuelven 404 aunque existen en WordPress. El diagnóstico con htaccess.madewithlove.com revela que las reglas de reescritura resuelven correctamente si se añade RewriteBase /tienda/. Es un ejemplo ilustrativo, pero representa un error muy real en instalaciones en subdirectorios.

Descarta conflictos con el caché del servidor o del navegador

Un cambio en .htaccess tiene efecto inmediato en Apache (el archivo se lee en cada petición), pero el navegador o una capa de caché en el servidor pueden estar sirviendo respuestas antiguas. Para descartar esto, haz la petición con curl y la opción --no-buffer, o añade un parámetro aleatorio a la URL (?nocache=1) para forzar una petición fresca. Si el comportamiento correcto aparece con ese parámetro pero no sin él, el problema es el caché, no el .htaccess.

Si usas un plugin de caché en WordPress como WP Rocket o W3 Total Cache, vacía la caché desde el panel antes de cualquier prueba. Estos plugins pueden generar su propio .htaccess o modificar el existente, lo que a veces entra en conflicto con reglas personalizadas.

Checklist de verificación completa para tu .htaccess

Antes de concluir que tu .htaccess tiene un problema complejo, pasa por esta lista en orden. Cada punto descarta una causa y te acerca al origen real del fallo.

  • El archivo se llama exactamente .htaccess, con el punto delante y sin extensión adicional.
  • El archivo está en el directorio correcto (normalmente la raíz del sitio, donde está wp-config.php en WordPress).
  • El archivo es visible en el gestor de archivos con la opción de mostrar archivos ocultos activada.
  • La prueba del error deliberado confirma que Apache lo lee (provoca error 500 con una línea inválida).
  • El log de errores de Apache no muestra Invalid command ni errores de sintaxis.
  • El módulo necesario (mod_rewrite, mod_headers, mod_expires…) está activo en el servidor.
  • La directiva AllowOverride no está configurada como None en el virtualhost.
  • Las pruebas se hacen con caché vaciada tanto en el navegador como en el servidor.
  • Las reglas de reescritura incluyen RewriteEngine On antes de cualquier RewriteRule.

Si tras completar esta lista el problema persiste, el siguiente paso es revisar los logs de error del servidor con el nivel de detalle rewrite:trace3 o contactar al soporte técnico del hosting con los resultados de cada punto. Llegar con ese diagnóstico previo reduce el tiempo de resolución de forma significativa.

Preguntas frecuentes sobre cómo saber si mi htaccess funciona

¿Cómo sé si Apache está ignorando mi .htaccess?

Añade una línea con texto sin sentido al principio del archivo y recarga el sitio. Si aparece un error 500, Apache lo está leyendo. Si la página carga con normalidad, el archivo se está ignorando. La causa más habitual es que la directiva AllowOverride esté configurada como None en la configuración del servidor o del virtualhost.

¿El .htaccess funciona en servidores Nginx?

No. El archivo .htaccess es exclusivo de servidores Apache. Nginx no lo lee ni lo interpreta. Si tu hosting usa Nginx, las reglas equivalentes deben configurarse en el bloque de servidor o de localización del virtualhost de Nginx. Algunos hostings usan Apache y Nginx en paralelo, en cuyo caso el .htaccess puede funcionar solo para ciertas peticiones.

¿Puede un .htaccess mal configurado afectar al SEO?

Sí, y de varias formas. Una redirección incorrecta puede enviar a Google a una URL que no existe (error 404) o crear un bucle infinito que el rastreador abandona. Una reescritura que genera URLs duplicadas puede diluir la autoridad de las páginas. Las directivas de caché mal configuradas pueden hacer que Google reciba respuestas desactualizadas. El impacto en el posicionamiento depende de qué directivas fallan y en cuántas páginas.

¿Cómo verifico que una redirección en .htaccess devuelve el código correcto (301 o 302)?

Abre las DevTools del navegador (F12), ve a la pestaña Network, activa Preserve log y visita la URL que debería redirigir. En el listado de peticiones verás el código de respuesta de la primera solicitud. También puedes usar el comando curl -I https://tudominio.com/pagina en la terminal, que muestra las cabeceras de respuesta sin seguir la redirección.

¿Puedo tener más de un .htaccess en mi sitio?

Sí. Apache permite un archivo .htaccess por directorio. Las reglas del directorio más profundo tienen prioridad sobre las del directorio padre cuando hay conflicto. En WordPress, el principal está en la raíz, pero plugins o configuraciones específicas pueden colocar uno adicional en subdirectorios como wp-content/uploads/ para restringir la ejecución de scripts.

¿Los cambios en .htaccess tienen efecto inmediato?

En Apache, sí: el archivo se lee en cada petición, así que cualquier cambio es inmediato sin necesidad de reiniciar el servidor. Sin embargo, si el navegador o una capa de caché del servidor almacenó una respuesta anterior, puede parecer que el cambio no tiene efecto. Vacía la caché del navegador y del plugin de caché de WordPress antes de comprobar el resultado.

¿Qué hago si no tengo acceso SSH para revisar los logs de Apache?

Tienes dos opciones principales. La primera es usar el panel de control del hosting (cPanel, Plesk) para acceder a los logs de error desde la sección de estadísticas o logs. La segunda es usar herramientas online como htaccess.madewithlove.com para simular el motor de mod_rewrite sin necesidad de acceso al servidor. Para errores de sintaxis, el método de bisección (comentar la mitad de las reglas) también funciona sin SSH.

    Comments are closed

    Esta web utiliza cookies propias para su correcto funcionamiento. Contiene enlaces a sitios web de terceros con políticas de privacidad ajenas que podrás aceptar o no cuando accedas a ellos. Al hacer clic en el botón Aceptar, acepta el uso de estas tecnologías y el procesamiento de tus datos para estos propósitos. Más información
    Privacidad