Resolución de problemas de carga de recursos en iTop tras cambio de dominio

Tras un cambio de dominio o de URL de acceso en iTop, es relativamente frecuente encontrarse con una situación en la que la aplicación es accesible, pero no carga correctamente los recursos estáticos (CSS, JavaScript, imágenes). El resultado suele ser una interfaz rota o sin estilos.

Este artículo describe las causas más comunes de este problema y el procedimiento técnico recomendado para su diagnóstico y resolución.

Síntomas habituales

La página principal de iTop se muestra en blanco o sin estilos.
El login aparece sin formato CSS.
En las herramientas de desarrollador del navegador (F12) se observan errores:
- 404 Not Found en archivos .css y .js.
- Errores de Mixed Content (HTTP dentro de HTTPS).
- Peticiones a un dominio antiguo.

Causa raíz más frecuente

En la mayoría de los casos, el problema se debe a una configuración incorrecta del parámetro app_root_url en iTop, lo que provoca que la aplicación genere URLs erróneas para los recursos estáticos.

En entornos con proxy inverso, el problema puede agravarse si iTop no es consciente de que está siendo servido detrás de HTTPS.

Procedimiento de resolución

1. Verificación y corrección de `app_root_url`

Editar el fichero de configuración de producción:

/conf/production/config-itop.php

Asegurarse de que el parámetro está definido correctamente:

'app_root_url' => 'https://itop.midominio.com',

Reglas importantes:

Debe coincidir exactamente con la URL real de acceso.
No debe llevar barra final (/).
El protocolo (http / https) debe ser correcto.
No debe apuntar a un dominio antiguo.

Una configuración incorrecta de este valor provoca que iTop construya mal las rutas de CSS y JavaScript.

2. Diagnóstico desde el navegador

Desde el navegador:

Abrir las herramientas de desarrollador (F12).
Revisar la pestaña Network y Console.
Identificar:
- Recursos que devuelven 404.
- URLs que apuntan a dominios incorrectos.
- Cargas en http cuando la web está en https.

Esto confirma rápidamente si el problema es de generación de URLs.

3. Consideraciones en entornos con proxy inverso

En arquitecturas con Nginx o Apache como proxy inverso, es imprescindible indicar a iTop que está detrás de un proxy.

En config-itop.php:

'behind_reverse_proxy' => true,

Además, el proxy debe reenviar las cabeceras correctas. Ejemplo en Nginx:

proxy_set_header Host $host;

proxy_set_header X-Forwarded-For $remote_addr;

proxy_set_header X-Forwarded-Proto https;

Sin esta configuración, iTop puede generar recursos en http aunque el acceso sea por https, provocando errores de mixed content.

4. Verificación de permisos

Aunque no suele ser la causa principal, es recomendable validar permisos:

chown-R www-data:www-data /var/www/itop

chmod-R755 /var/www/itop

Errores de permisos pueden derivar en 403 Forbidden al cargar recursos.

5. Limpieza completa de caché

Eliminar la caché interna de iTop:

rm-rf data/cache/*

Posteriormente:

Forzar recarga del navegador (Ctrl + F5).
O probar en una ventana de incógnito.

6. Prueba directa de recursos

Acceder directamente a un recurso estático desde el navegador:

https://itop.midominio.com/web/css/itop.css

Si no carga, el problema está en el virtual host o la ruta.
Si carga correctamente, el problema está en la configuración interna de iTop.

Conclusión

Cuando iTop carga la página pero no los recursos estáticos tras un cambio de dominio, el problema se debe casi siempre a:

Un valor incorrecto de app_root_url.
Falta de configuración adecuada para entornos con proxy inverso.

Revisar estos dos puntos, junto con una limpieza correcta de caché, suele resolver el problema en la gran mayoría de los casos.

Buenas prácticas

Documentar cualquier cambio de dominio o FQDN.
Revisar siempre app_root_url tras cambios de red o proxy.
Validar con herramientas de desarrollador antes de profundizar en otros diagnósticos.