La biblioteca de medios no carga imágenes: diagnóstico

Si la biblioteca de medios no carga imágenes, determina si faltan archivos existentes, si la cuadrícula se queda vacía o si falla una subida nueva. Son problemas diferentes: la primera situación puede deberse a URL o almacenamiento, la segunda a una petición de administración y la tercera a escritura, límites o procesamiento de imagen.

Separa visualización, consulta y subida

1. Abre un adjunto que antes funcionaba y copia su URL pública. Comprueba código HTTP y dominio. Si devuelve 404 tras migrar, verifica que el archivo existe en el destino y que la ruta no apunta al servidor antiguo.
2. Prueba la vista de lista además de la cuadrícula. Si la lista muestra elementos pero la cuadrícula no, revisa la consola y las solicitudes REST/Ajax, un plugin o un error JavaScript.
3. Sube una imagen pequeña y legítima, y anota el mensaje exacto. Si aparece un error al procesarla, comprueba memoria, biblioteca de imágenes y logs; si dice permiso denegado, mira propiedad y escritura en uploads.

No borres la base de adjuntos ni regeneres todas las miniaturas para averiguar qué ocurre. Antes, conserva copia de archivos y base. WordPress documenta que la subida necesita escritura en el directorio correspondiente y que genera subcarpetas y tamaños; consulta los ajustes de medios y la guía de adjuntos.

Comprueba migración y límites de forma dirigida

Tras cambiar de dominio, una URL de medios puede contener el host anterior. Busca algunos ejemplos en el HTML, la base y la configuración de CDN antes de sustituir referencias; las sustituciones de base deben respetar datos serializados y poder revertirse. Si el archivo existe pero su miniatura no, comprueba qué tamaños faltan y si el proceso de generación falló en el log. Si el error solo aparece con archivos grandes, compara dimensiones, formato, upload_max_filesize y memoria real; no subas todos los límites sin medir recursos. La guía de permisos sirve cuando hay evidencia de propiedad o escritura.

Ejemplo: después de una migración, las imágenes publicadas responden 200 en el dominio anterior, pero 404 en el nuevo. El problema es una referencia o copia incompleta, no una razón para desactivar el editor. En cambio, si un JPG pequeño sube y uno enorme falla con una traza de memoria, hay que medir el procesamiento y optimizar el original.

Criterio de cierre

Comprueba biblioteca, archivo original, miniatura y página que lo utiliza en escritorio y móvil. Retira la imagen de prueba y revisa que no queden rutas del host anterior. Si fue una migración, usa la lista posterior de WordPress. Pide ayuda con una URL afectada, tamaño/formato y mensaje exacto, sin compartir imágenes privadas.