Biblioteca multimedia rota en WordPress cómo arreglar

Introducción: biblioteca multimedia rota en WordPress

Cuando la biblioteca multimedia de WordPress se rompe, el sitio puede perder imágenes, iconos, documentos descargables y, en general, cualquier archivo que dependa de ella. Esto afecta al diseño, a la experiencia de usuario y al posicionamiento SEO, ya que las páginas pueden mostrar errores, imágenes rotas o tiempos de carga más altos. Entender qué ha ocurrido y cómo solucionarlo de forma ordenada es clave para recuperar la normalidad sin perder contenido.

Una biblioteca multimedia rota no siempre significa que los archivos hayan desaparecido del servidor. En muchos casos, el problema está en las rutas, los permisos, la base de datos o en conflictos con plugins y temas. A lo largo de esta guía se explica, paso a paso, cómo diagnosticar el origen del fallo y cómo aplicar las soluciones más eficaces, tanto con herramientas visuales como mediante ajustes técnicos básicos.

Síntomas comunes de una biblioteca multimedia rota

Identificar los síntomas concretos ayuda a acotar la causa del error. No todos los problemas con la biblioteca multimedia tienen el mismo origen, por lo que conviene anotar exactamente qué está fallando y en qué contexto se produce.

• Imágenes que antes se veían correctamente ahora aparecen como iconos rotos o en blanco.
• Al abrir la biblioteca multimedia, el listado aparece vacío o solo muestra una parte de los archivos.
• Errores al subir nuevos archivos, como mensajes de "No se ha podido crear el directorio" o "Error al subir el archivo".
• URLs de imágenes que devuelven errores 404 (no encontrado) o 403 (prohibido).
• Miniaturas que no se generan o se muestran distorsionadas tras subir una imagen.
• Archivos que existen físicamente en la carpeta wp-content/uploads pero no aparecen en la biblioteca de WordPress.
• Imágenes que desaparecen tras cambiar de dominio, mover el sitio o modificar la estructura de enlaces permanentes.

Causas más frecuentes de una biblioteca multimedia rota

La biblioteca multimedia depende de varios elementos: el sistema de archivos del servidor, la base de datos de WordPress, la configuración de URLs, los permisos y los recursos disponibles (memoria, espacio en disco, límites de subida, etc.). Cuando uno de estos componentes falla, la biblioteca puede dejar de funcionar correctamente.

• Rutas o URLs incorrectas: cambios de dominio, migraciones mal ejecutadas o ajustes erróneos en wp-config.php pueden provocar que WordPress busque los archivos en una ubicación distinta a la real.
• Permisos de archivos y carpetas: permisos demasiado restrictivos en la carpeta uploads impiden que WordPress lea o escriba archivos.
• Entradas huérfanas en la base de datos: archivos eliminados por FTP sin actualizar la base de datos, o viceversa, generan referencias rotas.
• Plugins conflictivos: plugins de optimización de imágenes, seguridad, caché o migración pueden modificar rutas, bloquear peticiones o borrar archivos sin actualizar la biblioteca.
• Límites del servidor: restricciones de tamaño de archivo, memoria PHP insuficiente o límites de ejecución pueden interrumpir subidas y procesos de generación de miniaturas.
• Errores tras una migración: mover el sitio entre servidores o de HTTP a HTTPS sin actualizar correctamente las URLs suele dejar imágenes con rutas antiguas.
• Configuraciones de seguridad: reglas en .htaccess o en el firewall que bloquean el acceso a la carpeta de medios.

Conocer estas causas habituales permite priorizar las comprobaciones y aplicar soluciones específicas, en lugar de realizar cambios al azar que podrían empeorar la situación.

Comprobaciones previas y copias de seguridad

Antes de modificar configuraciones sensibles, conviene realizar una serie de comprobaciones básicas y asegurarse de disponer de copias de seguridad completas. Esto incluye tanto los archivos del sitio como la base de datos de WordPress, ya que la biblioteca multimedia se apoya en ambos componentes.

• Verificar si el problema afecta a todas las imágenes o solo a algunas secciones del sitio.
• Comprobar si las imágenes se ven correctamente al acceder directamente a su URL desde el navegador.
• Revisar si el problema se reproduce con otro navegador o dispositivo (para descartar caché local).
• Desactivar temporalmente el plugin de caché y vaciar la caché del sitio.
• Comprobar el espacio disponible en el servidor y el uso de inodos (en hosting compartido).
• Revisar el registro de errores de PHP y del servidor web (error_log) en busca de mensajes relacionados con la carpeta uploads o con funciones de imagen.

Reparar enlaces y rutas de archivos multimedia

Una de las causas más habituales de una biblioteca multimedia rota son las rutas o URLs incorrectas. Esto ocurre especialmente después de migraciones, cambios de dominio, modificaciones en la estructura de carpetas o ajustes manuales en la configuración de WordPress. Reparar estas rutas es un paso clave para que las imágenes vuelvan a mostrarse correctamente.

1. Comprobar la URL del sitio y de WordPress

En primer lugar, es importante verificar que las URLs principales del sitio están bien configuradas. Esto se hace desde el panel de administración de WordPress.

• Accede a Ajustes > Generales.
• Revisa los campos Dirección de WordPress (URL) y Dirección del sitio (URL).
• Asegúrate de que el protocolo (http/https) y el dominio son correctos y coinciden con la URL real del sitio.
• Si has cambiado recientemente de dominio o has activado HTTPS, confirma que estos cambios se reflejan aquí.

2. Actualizar enlaces permanentes

A veces, simplemente guardar de nuevo la estructura de enlaces permanentes puede regenerar reglas internas y resolver errores de rutas.

• Ve a Ajustes > Enlaces permanentes.
• Sin cambiar nada, haz clic en Guardar cambios.
• Prueba de nuevo a cargar páginas con imágenes rotas y la biblioteca multimedia.

3. Buscar y reemplazar URLs antiguas

Si el problema apareció tras cambiar de dominio, mover el sitio a otra carpeta o activar HTTPS, es probable que la base de datos siga almacenando URLs antiguas para muchas imágenes. En ese caso, conviene realizar un reemplazo masivo y cuidadoso.

• Instala un plugin de búsqueda y reemplazo seguro, como Better Search Replace o Velvet Blues Update URLs.
• Realiza primero un simulacro (modo dry run) para ver cuántas coincidencias se van a modificar.
• Busca la URL antigua (por ejemplo, http://tudominioantiguo.com/wp-content/uploads) y reemplázala por la nueva (por ejemplo, https://tudominionuevo.com/wp-content/uploads).
• Limita la búsqueda a tablas relevantes como wp_posts y wp_postmeta para minimizar riesgos.

Corregir permisos de la carpeta uploads

Si WordPress no puede leer o escribir en la carpeta wp-content/uploads, la biblioteca multimedia dejará de funcionar correctamente. Esto se traduce en errores al subir archivos, imágenes que no se muestran o miniaturas que no se generan. Ajustar los permisos de archivos y carpetas suele resolver este tipo de problemas.

1. Valores recomendados de permisos

Aunque pueden variar ligeramente según el proveedor de hosting, los valores más habituales y seguros son los siguientes:

• Carpetas: 755
• Archivos: 644

Estos permisos permiten que el servidor web lea y ejecute las carpetas, y lea los archivos, sin otorgar permisos de escritura excesivos que puedan suponer un riesgo de seguridad.

2. Cambiar permisos por FTP o desde el panel de control

Para ajustar los permisos, puedes utilizar un cliente FTP (como FileZilla) o el administrador de archivos del panel de control de tu hosting.

• Conéctate por FTP y localiza la carpeta wp-content/uploads.
• Haz clic derecho sobre la carpeta uploads y selecciona Permisos de archivo o similar.
• Establece el valor 755 para la carpeta y aplica de forma recursiva a todas las subcarpetas.
• Para los archivos dentro de uploads, establece el valor 644 y aplica de forma recursiva solo a archivos.

3. Verificar propietario y grupo

En algunos servidores, el problema no es solo el número de permisos, sino el usuario propietario de los archivos. Si los archivos pertenecen a un usuario distinto al que ejecuta el servidor web, WordPress puede no tener acceso suficiente.

• Si tienes acceso SSH, puedes usar comandos como ls -l para comprobar propietario y grupo.
• En caso de discrepancias, contacta con el soporte de tu hosting para que ajuste el propietario de los archivos al usuario correcto.

Regenerar miniaturas y metadatos de la biblioteca

En muchos sitios, la biblioteca multimedia parece rota porque las miniaturas no se muestran correctamente o porque los metadatos asociados a las imágenes están incompletos o dañados. Esto puede ocurrir tras cambiar de tema, modificar los tamaños de imagen o después de una migración. Regenerar miniaturas y metadatos ayuda a reconstruir la relación entre archivos físicos y entradas en la base de datos.

1. Usar un plugin para regenerar miniaturas

Una forma sencilla de reparar miniaturas es utilizar un plugin especializado. Uno de los más conocidos es Regenerate Thumbnails, aunque existen alternativas similares.

• Instala y activa el plugin Regenerate Thumbnails.
• Accede al menú del plugin en el panel de administración.
• Selecciona la opción para regenerar miniaturas de todas las imágenes o solo de las que falten.
• Inicia el proceso y espera a que finalice. En sitios con muchas imágenes puede tardar varios minutos.

Al finalizar, revisa algunas páginas y entradas para comprobar si las miniaturas se muestran correctamente en listados, galerías y widgets.

2. Reconstruir la biblioteca desde archivos existentes

Si los archivos existen en la carpeta uploads pero no aparecen en la biblioteca multimedia, puede ser necesario reconstruir las entradas de la base de datos a partir de los archivos físicos.

• Utiliza plugins como Media Tools o Add From Server (si está disponible y actualizado) para importar archivos existentes a la biblioteca.
• Escanea las carpetas dentro de uploads y selecciona los archivos que quieras añadir a la biblioteca.
• Ten en cuenta que, aunque los archivos se añadan a la biblioteca, es posible que haya que volver a asignarlos manualmente a algunas entradas o páginas.

Problemas tras migración o cambio de dominio

Una de las situaciones más comunes en las que la biblioteca multimedia se rompe es después de migrar el sitio a otro servidor, cambiar de dominio o mover WordPress a una subcarpeta diferente. En estos casos, las imágenes pueden seguir existiendo, pero las rutas almacenadas en la base de datos ya no coinciden con su ubicación real.

1. Verificar estructura de carpetas tras la migración

Tras una migración, es importante comprobar que la carpeta wp-content/uploads se ha copiado completa y mantiene la misma estructura de años y meses que en el sitio original.

• Accede por FTP o al administrador de archivos del nuevo servidor.
• Comprueba que dentro de uploads existen las subcarpetas por año (por ejemplo, 2022, 2023, etc.).
• Verifica que las imágenes están presentes dentro de esas subcarpetas.

2. Actualizar URLs internas tras el cambio de dominio

Si el dominio ha cambiado, es imprescindible actualizar todas las referencias internas en la base de datos. Esto incluye enlaces a imágenes, pero también a páginas, menús y otros recursos.

• Utiliza un plugin de migración que realice este proceso automáticamente, o bien un plugin de búsqueda y reemplazo como se explicó en secciones anteriores.
• Asegúrate de reemplazar tanto la URL con http como con https, si has cambiado el protocolo.
• Revisa especialmente las tablas wp_posts, wp_postmeta y, si procede, tablas de plugins de galerías.

3. Comprobar redirecciones y reglas de .htaccess

En algunos casos, las imágenes no se muestran porque las redirecciones o reglas de seguridad en .htaccess están bloqueando el acceso a la carpeta de medios o redirigiendo a rutas incorrectas.

• Abre el archivo .htaccess en la raíz de WordPress.
• Comprueba si hay reglas personalizadas que afecten a /wp-content/uploads/.
• Si sospechas que una regla está causando el problema, coméntala temporalmente (añadiendo # al inicio de la línea) y prueba de nuevo.

Plugins conflictivos y límites del servidor

Los plugins y la configuración del servidor también pueden ser responsables de una biblioteca multimedia rota. Plugins de seguridad, optimización de imágenes, caché o CDN pueden interferir en la forma en que WordPress gestiona los archivos multimedia. Además, límites estrictos de recursos en el servidor pueden interrumpir subidas y procesos de generación de imágenes.

1. Detectar plugins conflictivos

Para saber si un plugin está causando el problema, se puede realizar una prueba de conflicto desactivando temporalmente todos los plugins y reactivándolos uno a uno.

• Desactiva todos los plugins desde Plugins > Plugins instalados.
• Comprueba si la biblioteca multimedia vuelve a funcionar con todos los plugins desactivados.
• Si funciona, reactiva los plugins uno a uno, comprobando la biblioteca tras cada activación.
• Cuando el problema reaparezca, habrás identificado el plugin conflictivo.

En el caso de plugins de seguridad o firewall, revisa si tienen reglas específicas que bloqueen el acceso a wp-content/uploads o a tipos de archivo concretos.

2. Revisar límites de subida y memoria en PHP

Si el problema se manifiesta al subir nuevos archivos (por ejemplo, imágenes grandes que no se completan), puede deberse a límites de tamaño o memoria configurados en PHP.

• Comprueba los valores de upload_max_filesize, post_max_size y memory_limit en la configuración de PHP.
• Si son demasiado bajos, solicita a tu proveedor de hosting que los aumente o modifícalos desde php.ini, .htaccess o wp-config.php, según las posibilidades de tu servidor.
• Un valor razonable para sitios con muchas imágenes puede ser, por ejemplo, 128M o 256M para memory_limit, y 32M o más para upload_max_filesize.

3. CDN y rutas externas de imágenes

Si utilizas una CDN (red de distribución de contenidos) o un servicio externo para servir imágenes, la biblioteca multimedia puede parecer rota cuando en realidad el problema está en la configuración de la CDN o en las rutas externas.

• Desactiva temporalmente la CDN o el plugin que la gestiona y comprueba si las imágenes vuelven a cargarse desde el servidor principal.
• Revisa la configuración de la CDN para asegurarte de que está apuntando a la ruta correcta de uploads.
• Purga la caché de la CDN para forzar la actualización de los recursos.

Buenas prácticas para prevenir errores en la biblioteca

Una vez reparada la biblioteca multimedia, es importante aplicar una serie de buenas prácticas para reducir la probabilidad de que el problema se repita. La prevención incluye tanto aspectos técnicos como organizativos, y ayuda a mantener el sitio más estable y fácil de gestionar a largo plazo.

1. Mantener WordPress, temas y plugins actualizados

Las actualizaciones corrigen errores, mejoran la compatibilidad y refuerzan la seguridad. Trabajar con versiones obsoletas aumenta el riesgo de conflictos y fallos en la biblioteca multimedia.

• Programa revisiones periódicas para actualizar WordPress, el tema activo y los plugins.
• Evita instalar plugins que no se actualizan desde hace años o que tienen malas valoraciones.
• Prueba las actualizaciones en un entorno de staging cuando el sitio sea crítico.

2. Organizar y optimizar las imágenes antes de subirlas

Subir imágenes excesivamente grandes o en formatos poco adecuados puede sobrecargar el servidor y aumentar la probabilidad de errores durante la subida o la generación de miniaturas.

• Redimensiona las imágenes a un tamaño razonable antes de subirlas (por ejemplo, 1920px de ancho máximo para fondos y 1200px para imágenes de contenido).
• Comprime las imágenes con herramientas como TinyPNG, Squoosh o servicios similares.
• Utiliza formatos apropiados (JPG para fotografías, PNG o SVG para gráficos con transparencia, WebP si tu servidor lo soporta).

3. Evitar manipular la carpeta uploads sin control

Borrar o mover archivos directamente por FTP sin actualizar la base de datos puede dejar entradas huérfanas en la biblioteca multimedia y provocar imágenes rotas en el contenido.

• Siempre que sea posible, elimina imágenes desde la propia biblioteca de WordPress, no solo por FTP.
• Si necesitas reorganizar carpetas, utiliza plugins diseñados para gestionar medios sin romper las referencias.
• Documenta cualquier cambio manual que hagas en la estructura de archivos para poder revertirlo si es necesario.

4. Implementar una estrategia de copias de seguridad

Disponer de copias de seguridad fiables es la mejor garantía para recuperar rápidamente la biblioteca multimedia en caso de fallo grave, ataque o error humano.

• Configura copias de seguridad automáticas que incluyan archivos y base de datos.
• Guarda las copias en una ubicación externa al servidor principal (por ejemplo, almacenamiento en la nube).
• Realiza pruebas de restauración periódicas para asegurarte de que las copias son utilizables.

Preguntas frecuentes