Error 415 en WordPress, solución rápida

El error 415 en WordPress suele indicar que el servidor o la propia aplicación rechazan una petición porque el formato enviado no coincide con el esperado. Es habitual al subir archivos a la biblioteca multimedia, usar formularios, conectar integraciones externas o trabajar con la API REST de WordPress.

En términos simples, un 415 Unsupported Media Type significa “tipo de contenido no admitido”. Normalmente intervienen el tipo MIME del archivo, la cabecera Content-Type, una validación del servidor web o un conflicto introducido por plugins, firewall o CDN.

Qué significa el error 415 en WordPress y por qué aparece

WordPress acepta ciertos tipos de archivo y determinadas peticiones HTTP solo si el contenido, las cabeceras y el formato son válidos. Si el sistema recibe una imagen con un MIME no permitido, una petición JSON sin la cabecera correcta o una subida alterada por un proxy o firewall, puede devolver un 415.

Conviene distinguir dos escenarios. El primero es un problema de archivo o validación MIME: por ejemplo, una extensión que no coincide con el contenido real del fichero. El segundo es un problema de servidor o API: una cabecera incorrecta, una regla de seguridad, un plugin que modifica peticiones o una integración que envía datos con un formato no esperado.

Causas más habituales del error 415 en WordPress

• Archivo no admitido o mal identificado: ocurre mucho con SVG, WEBP en entornos antiguos, documentos exportados por herramientas externas o imágenes con extensión cambiada manualmente.
• Cabecera Content-Type incorrecta: frecuente en llamadas a la API REST de WordPress o integraciones hechas con plugins, formularios o automatizaciones.
• Conflicto de plugin o tema: algunos plugins de seguridad, optimización, formularios o constructores pueden filtrar peticiones o alterar subidas.
• Configuración del servidor en WordPress: Apache, nginx, ModSecurity, WAF, CDN o Cloudflare pueden bloquear ciertos tipos MIME o métodos HTTP.
• REST API restringida: si el error 415 en REST API aparece solo en ciertos endpoints, puede deberse al formato enviado o a una validación concreta del plugin que expone ese endpoint.

Cómo solucionar el error 415 paso a paso sin empeorar el sitio

1. Haz copia de seguridad y, si puedes, reproduce el problema en staging. Evita cambios directos en producción sin una prueba mínima.
2. Identifica el contexto exacto: subida de medios, formulario, editor, plugin tercero o API REST. Esa pista acota mucho el origen.
3. Valida el archivo si el error 415 al subir archivos aparece en la biblioteca multimedia. Reexporta el fichero, comprueba su extensión y descarta que esté dañado.
4. Revisa la cabecera Content-Type si el fallo afecta a integraciones o peticiones AJAX/REST. En JSON debería enviarse como application/json cuando corresponda, no como un formato arbitrario.
5. Desactiva temporalmente plugins de seguridad, caché, optimización o formularios, uno a uno. Si desaparece el problema, ya tienes un conflicto localizado.
6. Cambia al tema por defecto de forma temporal solo para descartar funciones personalizadas que intercepten peticiones o subidas.
7. Consulta logs del servidor y, si aplica, activa el modo debug de WordPress con prudencia. Un registro puede mostrar si bloquea PHP, el WAF o una regla MIME.

Qué revisar en plugins, tema, servidor y API REST

Plugins y tema

Algunos plugins filtran tipos de archivo permitidos, validan formularios o alteran cabeceras HTTP. Si el problema empezó tras una actualización, conviene revisar el changelog y repetir la acción con el plugin desactivado. En temas a medida, también puede haber código que modifique subidas o endpoints.

Servidor, CDN y firewall

En ciertos hostings, ModSecurity, reglas del WAF o una CDN pueden rechazar peticiones que parezcan anómalas. No siempre es un fallo de WordPress: a veces el servidor web corta la solicitud antes. Si usas nginx o Apache, el soporte técnico puede confirmar si se está bloqueando un MIME, un método HTTP o una cabecera concreta.

API REST de WordPress

Si ves un WordPress unsupported media type en un endpoint REST, comprueba formato del cuerpo, autenticación y cabeceras. Un JSON mal formado o enviado como multipart/form-data cuando el endpoint espera otra cosa puede provocar el rechazo.

Cómo evitar que el error 415 vuelva a aparecer

• Mantén WordPress, tema y plugins actualizados, pero prueba cambios sensibles en staging.
• No fuerces extensiones de archivo manualmente; verifica siempre el tipo real del contenido.
• Documenta qué integraciones usan la REST API y qué cabeceras esperan.
• Revisa reglas de seguridad y caché tras cambios en CDN, firewall o hosting.
• Supervisa errores en consola y logs cuando incorpores formularios, automatizaciones o nuevas subidas de medios.

En resumen, el error 415 en WordPress no suele tener una única causa: puede estar en el archivo, en la validación MIME, en las cabeceras o en la capa de servidor. Lo más seguro es diagnosticar primero, hacer pruebas controladas y apoyarse en logs antes de tocar configuraciones delicadas. Si el fallo persiste tras revisar plugins, tema, servidor y API, el siguiente paso razonable es escalarlo con soporte técnico especializado para evitar cambios innecesarios en producción.