Artículo

Crear una aplicación de Spring Boot con Spring Initializr

Crea tu primera aplicación de Spring Boot paso a paso con Spring Initializr (start.spring.io): proyecto, lenguaje, dependencias y generación por terminal.

Crear una aplicación de Spring Boot con Spring Initializr

Para crear una aplicación de Spring Boot entra en start.spring.io (Spring Initializr), elige Maven o Gradle, Java y las dependencias que necesites, pulsa Generate y abre el proyecto descargado en tu IDE. Con ./mvnw spring-boot:run tendrás un servidor web funcionando en el puerto 8080.

Probado en noviembre de 2026 con Spring Boot 4.1, la versión que Spring Initializr ofrece por defecto.

Qué necesitas

  • JDK 17 o superior. Spring Boot 4 no funciona con versiones anteriores. Si no lo tienes, sigue la guía para instalar Java.
  • Un IDE: IntelliJ IDEA, Eclipse o Visual Studio Code.
  • No hace falta instalar Maven ni Gradle: el proyecto generado trae su propio wrapper (mvnw o gradlew).

Crear el proyecto con Spring Initializr

Spring Initializr es el generador oficial de proyectos. Rellenas un formulario y te descarga un zip con la estructura lista. Estas son sus opciones:

Project

La herramienta de construcción: Maven o Gradle (con Groovy o con Kotlin). Las dos sirven. Si empiezas, Maven tiene más ejemplos y documentación en español.

Language

Java, Kotlin o Groovy. En esta guía usamos Java.

Spring Boot

La versión de Spring Boot. Deja la que viene marcada, que es la última estable. Evita las que terminan en SNAPSHOT o M1: son versiones en desarrollo.

Project Metadata

Los datos que identifican tu proyecto:

  • Group: el identificador de tu organización, normalmente un dominio al revés (com.ejemplo).
  • Artifact y Name: el nombre del proyecto (demo).
  • Package name: el paquete raíz de tu código (com.ejemplo.demo).
  • Packaging: Jar. Spring Boot lleva el servidor Tomcat dentro del propio jar.
  • Java: la versión de tu JDK.

Dependencies

Pulsa Add Dependencies y busca Spring Web. Es lo único que necesitas para una aplicación web o una API REST. Más adelante podrás añadir otras (Spring Data JPA, Spring Security) editando el pom.xml.

Generate

Pulsa Generate, descomprime el zip y abre la carpeta con tu IDE.

Crear el proyecto desde la terminal

Spring Initializr también tiene una API. Este comando genera el mismo proyecto Maven con Spring Web:

curl https://start.spring.io/starter.zip -d type=maven-project -d language=java -d dependencies=web -d baseDir=demo -o demo.zip
unzip demo.zip
cd demo

Para Gradle, cambia type=maven-project por type=gradle-project.

Estructura del proyecto

demo/
├── mvnw, mvnw.cmd          # wrapper de Maven
├── pom.xml                 # dependencias y configuración de la construcción
└── src/
    ├── main/
    │   ├── java/com/example/demo/DemoApplication.java
    │   └── resources/application.properties
    └── test/java/com/example/demo/DemoApplicationTests.java

La clase principal ya está escrita:

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

@SpringBootApplication activa la autoconfiguración y el escaneo de componentes a partir de ese paquete. El método main arranca la aplicación y su servidor integrado.

Añadir un primer endpoint

Crea esta clase junto a DemoApplication:

@RestController
public class HolaController {

    @GetMapping("/hola")
    public String hola() {
        return "Hola desde Spring Boot";
    }
}

Ejecutar la aplicación

Con Maven:

./mvnw spring-boot:run

Con Gradle:

./gradlew bootRun

En Windows usa mvnw.cmd o gradlew.bat. Cuando el log muestre que Tomcat ha arrancado en el puerto 8080, abre http://localhost:8080/hola en el navegador y verás el texto.

Para cambiar el puerto, añade server.port=9090 en application.properties, o usa configuración en YAML.

Preguntas frecuentes

¿Qué es Spring Initializr?

Es la herramienta oficial de Spring, disponible en start.spring.io, que genera la estructura de un proyecto Spring Boot con las dependencias que elijas.

¿Maven o Gradle?

Los dos funcionan igual de bien con Spring Boot. Maven es más común en tutoriales y empresas con proyectos antiguos; Gradle compila más rápido en proyectos grandes.

¿Qué versión de Java necesito para Spring Boot?

Spring Boot 3 y 4 necesitan Java 17 como mínimo.

¿Necesito instalar Tomcat?

No. Spring Boot lo incluye dentro de la aplicación y lo arranca al ejecutarla.

¿Puedo crear el proyecto desde el IDE?

Sí. IntelliJ IDEA, Eclipse (Spring Tools) y Visual Studio Code tienen un asistente que usa Spring Initializr por debajo.

Artículos relacionados

Si quieres seguir paso a paso, el curso de introducción a Spring Boot parte de este mismo proyecto.

Newsletter Semanal de Java

Cada viernes recibe lo más nuevo del ecosistema Java: frameworks, herramientas y mejores prácticas.

Sin spam. Cancela cuando quieras.

Compartir artículo