Descarga de un archivo WAR de prueba: un WAR de prueba seguro para el despliegue en Apache Tomcat

Consigue un archivo war de prueba para probar de forma segura el despliegue en Tomcat, las canalizaciones CI/CD y las configuraciones del servidor. Guía paso a paso para descargar, desplegar y solucionar problemas.

Desplegar una compilación no probada en un contenedor Tomcat en funcionamiento es una de las formas más rápidas de perder una tarde — y un archivo WAR de prueba es el seguro más barato que puedes conseguir. Un archivo WAR de prueba es un archivo web desplegable diminuto cuyo único cometido es demostrar que tu servidor, tus rutas y tu canalización funcionan realmente antes de que aparezca el código real. Normalmente incluye poco más que una página de bienvenida y un descriptor de despliegue, así que cuando se despliega sin errores sabes que el problema nunca estuvo en tu infraestructura. Esta guía cubre dónde descargar uno, cómo desplegarlo y cómo interpretar los errores cuando falla.

¿Qué es exactamente un archivo WAR de prueba?

Un WAR (archivo de aplicación web) es simplemente un archivo ZIP con una estructura interna muy concreta. Los contenedores de servlets —Tomcat, Jetty, WildFly y compañía— buscan esa estructura y nada más. Un archivo WAR de prueba lo reduce todo al mínimo que un contenedor seguirá aceptando: un descriptor WEB-INF/web.xml, un index.html estático en la raíz y absolutamente ninguna lógica de aplicación.

Esa huella mínima es precisamente el objetivo. Si un archivo WAR de prueba se despliega y se renderiza, has aislado la variable. Cualquier fallo posterior pertenece a tu aplicación real, no a tu entorno.

ArchivoPropósitoContenido típicoSe despliega en
.warAplicación webWEB-INF/, recursos estáticosContenedor de servlets (Tomcat)
.jarBiblioteca o ejecutableClases, META-INF/Classpath o java -jar
.earAplicación empresarialVarios módulosServidor Java EE / Jakarta EE
.zipArchivo comprimido genéricoCualquier cosaEn ningún sitio, por defecto

Qué contiene un archivo WAR de prueba mínimo

  • WEB-INF/web.xml — el descriptor de despliegue. Es opcional desde Servlet 3.0, pero incluir uno hace que tu prueba sea más realista.
  • index.html — una página de bienvenida estática para que puedas confirmar que la aplicación realmente se está sirviendo.
  • WEB-INF/classes/ — una carpeta vacía en la mayoría de las compilaciones de prueba, presente solo para reflejar la estructura real.
  • META-INF/MANIFEST.MF — metadatos opcionales; inofensivos en cualquier caso.

Un archivo WAR de prueba bien construido suele ocupar menos de 10 KB. Si descargas algo que dice ser un WAR de prueba y pesa 40 MB, es una aplicación real disfrazada.

Dónde descargar un archivo WAR de prueba

Tienes cuatro caminos realistas, y el correcto depende de lo que realmente intentes demostrar.

OpciónIdeal paraTamaño típicoEsfuerzo
WAR de ejemplo oficial de Apache TomcatPrimera prueba de despliegueDecenas de KBNinguno: descargar
Compilación con Maven maven-archetype-webappProbar una canalización de compilación realPequeñoBajo: mvn package
ZIP creado a mano y renombrado a .warComprobaciones en entornos aislados o sin conexiónMenos de 2 KBBajo
Aplicaciones de ejemplo del proveedor del contenedorVerificar una versión específica del entorno de ejecuciónVariableMedio

La ruta más rápida para la mayoría es la aplicación de ejemplo que incluye el propio proyecto Tomcat. La documentación oficial de la aplicación de ejemplo de Apache Tomcat explica que la aplicación de ejemplo se empaqueta como WAR y se puede descargar directamente, con una advertencia que conviene repetir: asegúrate de que tu navegador no cambie el nombre de la extensión del archivo ni añada una nueva. Se sabe que tanto Chrome como Edge han convertido sample.war en sample.zip o sample.war.zip en ciertos sistemas.

Si tu archivo llega con una extensión duplicada, el contenedor lo ignorará en silencio. Te quedarás mirando un 404 preguntándote qué se rompió. Cámbiale el nombre y sigue adelante.

Si quieres que el archivo WAR de prueba ponga a prueba tus herramientas de compilación reales, genéralo en lugar de descargarlo:

mvn archetype:generate -DgroupId=com.example \
  -DartifactId=dummy-war \
  -DarchetypeArtifactId=maven-archetype-webapp

Después, ejecuta mvn package y recoge el artefacto de target/. Ahora tienes un archivo WAR de prueba que pasó por la misma cadena de herramientas que tus compilaciones de producción, lo que supone una prueba considerablemente mejor.

Cómo desplegar un archivo WAR de prueba en Tomcat

El despliegue es deliberadamente aburrido, que es exactamente lo que quieres en una prueba de humo. El procedimiento estándar:

PasoAcciónQué verificar
1Copia el WAR en $CATALINA_HOME/webappsEl archivo llega con el .war intacto
2Inicia Tomcat (catalina.sh run o startup.sh)Sin trazas de pila en catalina.out
3Observa la autoexpansiónAparece una carpeta con el nombre del WAR
4Abre http://localhost:8080/<context>/La página de bienvenida se renderiza
5Vuelve a leer el final del registroArranque limpio, sin bucle de redespliegue

La ruta de contexto se deriva del nombre del archivo. Un archivo llamado sample.war se convierte en /sample. Si quieres la aplicación en la raíz del servidor, nómbralo ROOT.war. Este detalle confunde a más principiantes que cualquier otro.

Tampoco tienes que desplegarlo para inspeccionarlo. Como un WAR es un ZIP, puedes descomprimirlo primero:

jar -xvf sample.war

Eso te da un árbol de directorios que puedes leer antes de subir nada a un servidor. Es la forma más segura de comprobar que una descarga desconocida es realmente un archivo WAR de prueba y no algo con un WEB-INF/lib lleno de sorpresas.

Ajustes del servidor que afectan al despliegue

Ajuste (en Host)Valor predeterminadoQué haceCuándo cambiarlo
autoDeploytrueVuelve a desplegar cuando aparece un nuevo WARDesactívalo en producción
unpackWARstrueExpande el WAR en un directorioMantenlo en true para facilitar la depuración
deployOnStartuptrueDespliega las aplicaciones existentes al arrancarDesactívalo para tener control manual
appBasewebappsDirectorio que se analiza en busca de aplicacionesApúntalo a otro sitio para estructuras personalizadas

Para un despliegue de prueba, deja todo con los valores predeterminados. Todo el valor del ejercicio consiste en confirmar que el comportamiento de fábrica funciona. Ajusta la configuración solo después de tener una referencia.

Solucionar problemas de un archivo WAR de prueba que no se despliega

Cuando un archivo WAR de prueba falla, el error casi siempre es del entorno, lo que hace que sea fácil de corregir una vez que sabes dónde mirar.

SíntomaCausa probableSolución
404 en /sample/Nombre de contexto incorrecto o uso de mayúsculas distintoComprueba el nombre de la carpeta expandida y haz que coincida exactamente
El WAR nunca se expandeunpackWARs o autoDeploy desactivadosVuelve a activarlos o reinicia Tomcat
"Archivo WAR no válido o ilegible"El navegador lo renombró a .zip, o la descarga se truncóVuelve a descargarlo, verifícalo con unzip -t sample.war
Error 500 en la peticiónweb.xml mal formadoValídalo con la versión correcta de la especificación de Servlet
Bucle de redespliegue repetidoDos copias del mismo WARElimina los duplicados de webapps
Funciona en local, falla en CIVersión principal de Tomcat diferenteComprueba el espacio de nombres; consulta más abajo

Esa última fila merece énfasis. Tomcat 10 y versiones posteriores pasaron del espacio de nombres javax.servlet a jakarta.servlet. Un archivo WAR de prueba creado para Tomcat 9 que haga referencia a clases javax.servlet puede fallar en Tomcat 10+ con errores de clase no encontrada. Los archivos de prueba puramente estáticos suelen sobrevivir al salto porque no contienen ningún servlet compilado, un argumento más para mantener tu WAR de prueba mínimo.

Los informes de la comunidad de responsables de CI señalan sistemáticamente a los mismos tres culpables: el cambio de nombre de la extensión, las suposiciones sobre la ruta de contexto y la desviación de versiones. Ninguno de ellos es un problema de código.

Buenas prácticas para usar un archivo WAR de prueba en CI/CD

Trata el archivo WAR de prueba como una pieza permanente de la infraestructura de pruebas en lugar de una descarga puntual. Así es como los equipos le sacan el máximo partido:

Etapa de la canalizaciónCómo ayuda el WAR de pruebaSeñal de éxito
Configuración localConfirma que Tomcat está instalado y es accesibleLa página de bienvenida carga
CompilaciónVerifica el empaquetado y la nomenclatura del artefactomvn package produce un .war
Trabajo de despliegue en CIPrueba la subida, los permisos y la lógica de reinicioEl trabajo termina en verde
Línea base de stagingDemuestra que el host de destino funciona antes del despliegue realcatalina.out limpio
MonitorizaciónActúa como aplicación de referencia para las comprobaciones de estadoHTTP 200 desde una página estática

Hábitos prácticos que conviene adoptar:

  • Fija el nombre del archivo. Incluye el nombre del contexto en tus scripts de despliegue para que sample.war nunca se convierta en sample-2.war.
  • Calcula la suma de comprobación de tu descarga. Guarda un hash SHA-256 para saber que se está probando el mismo artefacto cada vez.
  • Vuelve a probar después de cada actualización de Tomcat. Un cambio de versión menor puede modificar los valores predeterminados de despliegue.
  • Mantenlo fuera de producción. Un archivo WAR de prueba en un servidor público es inofensivo, pero también es ruido. Usa un host de staging.
  • Registra la ruta de despliegue. La mayoría de los incidentes de "funcionaba ayer" son en realidad "el appBase cambió ayer".

Si quieres una prueba un poco más realista, añade un servlet trivial o un endpoint de estado a tu compilación de prueba. Así estarás ejercitando el ciclo de vida del servlet, no solo el servicio de archivos estáticos, lo que detecta toda una clase diferente de errores de configuración.

Preguntas frecuentes

¿Es seguro desplegar un archivo WAR de prueba en un servidor que no controlo? Uno bien construido es solo una página HTML estática y un descriptor XML, así que no hay nada que explotar. Aun así, descomprímelo con jar -xvf antes de desplegarlo y confirma que no haya un WEB-INF/lib lleno de JAR desconocidos. Confía, pero verifica.

¿Cuál es la diferencia entre un archivo WAR de prueba y sample.war? Funcionalmente, ninguna. sample.war es la aplicación de ejemplo oficial de Apache y sirve como el archivo WAR de prueba más utilizado en la práctica. Un archivo WAR de prueba hecho en casa es simplemente una versión que tú mismo construiste con menos piezas móviles.

¿Funcionará un archivo WAR de prueba en Tomcat 10 u 11? Normalmente sí, siempre que no contenga servlets compilados. Si hace referencia a clases javax.servlet, fallará en Tomcat 10+ porque el espacio de nombres pasó a jakarta.servlet. Vuelve a compilarlo con la especificación de Servlet correspondiente.

¿Cómo creo mi propio archivo WAR de prueba desde cero? Crea una carpeta, añade index.html en la raíz y un web.xml mínimo dentro de WEB-INF/, luego comprime el contenido —no la carpeta contenedora— y cambia el nombre del archivo con la extensión .war. Colócalo en webapps y tendrás un artefacto de prueba funcional en menos de dos minutos.

Por Actualizado