Cómo solucioné un error de Simply Static tras migrar un WordPress
Tras migrar un WordPress, Simply Static dejó de generar el ZIP. El problema no era el dominio, sino una ruta absoluta que seguía apuntando al servidor anterior.
Nota: El problema descrito en este artículo se produjo utilizando Simply Static 3.7.2. Es posible que en versiones posteriores cambie la ubicación de la configuración o el comportamiento del plugin.
Hace unos días me encontré con un problema bastante curioso al migrar una instalación de WordPress a un nuevo servidor.
La migración había ido bien.
- La web cargaba correctamente.
- El dominio respondía sin problemas.
- La base de datos estaba actualizada.
- El certificado SSL funcionaba.
Todo parecía indicar que el trabajo había terminado.
Sin embargo, al intentar generar la versión estática de la web con Simply Static, el proceso fallaba.
Un error poco evidente
Simply Static permite generar una copia completamente estática de una web WordPress para publicarla posteriormente en cualquier servidor.
En mi caso, al iniciar la generación del ZIP, el proceso terminaba con un error.
Lo curioso era que la web funcionaba perfectamente. No había errores en WordPress ni en el servidor, por lo que la causa no era nada evidente.
La investigación
Como suele ocurrir en este tipo de situaciones, empecé revisando lo habitual.
- URLs antiguas.
- Configuración de WordPress.
- Permisos de archivos.
- Cachés.
- Base de datos.
Todo parecía estar correcto.
Así que decidí revisar la configuración del propio plugin.
Y ahí apareció el problema.
La configuración que había sobrevivido a la migración
Dentro de los ajustes avanzados de Simply Static existe un apartado para definir el directorio donde almacenar los archivos temporales durante la generación.
La ruta configurada seguía siendo la del servidor anterior.
Algo similar a esto:
/var/www/vhosts/servidor-anterior/httpdocs/wp-content/plugins/simply-static/static-files/
Después de la migración, ese directorio simplemente ya no existía.
El plugin seguía intentando utilizarlo para generar sus archivos temporales y, como era de esperar, el proceso terminaba fallando.
La solución
La solución fue mucho más sencilla de lo que esperaba.
En Simply Static 3.7.2 bastó con acceder a:
Simply Static → Settings → Advanced → Debug → Temporary Files
y actualizar el directorio temporal para que apuntara a la ruta del nuevo servidor.
Después pulsé Clear Temporary Files para eliminar cualquier resto de ejecuciones anteriores.
Guardé la configuración.
Y lancé de nuevo la generación.
Esta vez el ZIP se generó sin ningún problema.
Consejo: Si has migrado tu WordPress a otro servidor y Simply Static deja de generar el ZIP, merece la pena revisar este ajuste antes de invertir tiempo buscando problemas en la base de datos, los permisos o la configuración de WordPress. En mi caso, esa única ruta era la causa del fallo.
Una buena lección
Cuando hacemos una migración solemos preocuparnos por:
- el dominio;
- la base de datos;
- las DNS;
- el certificado SSL;
- los enlaces internos.
Pero algunos plugins también almacenan configuraciones específicas del servidor, como rutas absolutas del sistema de archivos.
Ese tipo de configuración suele pasar desapercibida porque la web continúa funcionando con normalidad.
Solo descubres el problema cuando el plugin necesita acceder a una carpeta que ya no existe.
Un punto más para mi checklist
A partir de ahora, siempre que migre una instalación de WordPress revisaré también la configuración de los plugins que trabajen con archivos temporales, copias de seguridad o exportaciones.
Es una comprobación que apenas lleva un minuto y puede evitar bastante tiempo de depuración.
En este caso, el problema no estaba en WordPress.
Ni en Simply Static.
Ni siquiera en la migración.
Simplemente había una ruta absoluta que seguía apuntando al servidor anterior.
Preguntas frecuentes
¿Dónde se encuentra la opción "Temporary Files" en Simply Static 3.7.2?
En la versión 3.7.2 se encuentra en: Simply Static → Settings → Advanced → Debug → Temporary Files Desde ahí puede modificarse el directorio utilizado para almacenar los archivos temporales.
¿Es necesario reinstalar Simply Static para solucionar este problema?
No. En mi caso fue suficiente con actualizar la ruta del directorio temporal, limpiar los archivos temporales y volver a generar el ZIP.
¿Cómo puedo saber si la ruta configurada es incorrecta?
Si apunta a un directorio del servidor anterior o a una carpeta que ya no existe, Simply Static no podrá escribir los archivos temporales y el proceso de generación fallará.
¿Qué debo hacer después de modificar la ruta?
Lo recomendable es limpiar los archivos temporales mediante Clear Temporary Files, guardar la configuración y volver a ejecutar la generación de la versión estática.
¿Este problema solo afecta a Simply Static?
No. Muchos plugins de WordPress almacenan rutas absolutas del sistema de archivos para gestionar cachés, copias de seguridad, exportaciones o archivos temporales. Tras una migración es recomendable revisar este tipo de configuraciones.
¿Qué conviene revisar después de migrar una instalación de WordPress?
Además del dominio, la base de datos y los certificados SSL, es aconsejable comprobar los directorios temporales, las carpetas de caché, las rutas de exportación y cualquier configuración de plugins que dependa del sistema de archivos.
¿Qué enseñanza deja este problema?
Que una migración no termina cuando la web carga correctamente. Algunas incidencias solo aparecen cuando un plugin necesita acceder a recursos del servidor, por lo que revisar las rutas absolutas debería formar parte de cualquier checklist de migración.
¿Por qué Simply Static no genera el ZIP?
Simply Static necesita crear archivos temporales durante el proceso de generación. Si el directorio configurado para almacenarlos no existe o no tiene permisos de escritura, la generación del ZIP puede fallar.
¿Puede ocurrir este problema después de cambiar solo de servidor?
Sí. Aunque el dominio siga siendo el mismo, si cambia la ruta absoluta del servidor, Simply Static puede seguir apuntando al directorio antiguo y no ser capaz de generar los archivos temporales.
¿Te ha resultado útil o quieres comentar algo?
Hablemos →