Cómo dejar de depender de que Hibernate cree las tablas y llevar los cambios de la base de datos en scripts SQL numerados con Flyway, que se aplican solos y en orden al arrancar.
También te puede interesar
Por qué migraciones
En el curso, Hibernate creaba las tablas solo al arrancar. Con una base de datos real eso no sirve: no puede borrar la tabla de clientes para volverla a crear con una columna nueva. Lo correcto es escribir cada cambio de estructura como un script SQL numerado, una migración, y que una herramienta lleve la cuenta de cuáles ya se aplicaron en cada base. Flyway es la más usada con Spring Boot: al arrancar, revisa qué versión tiene la base y aplica en orden las que faltan.
Se agrega con la dependencia Flyway Migration de start.spring.io (spring-boot-starter-flyway). Los scripts van en src/main/resources/db/migration, con nombres V<número>__<descripción>.sql, con dos guiones bajos:
create table producto (
id bigint auto_increment primary key,
nombre varchar(100) not null,
precio numeric(10, 2) not null
);
insert into producto (nombre, precio) values ('Teclado mecánico', 1299.00), ('Mouse inalámbrico', 349.50);V1__crear_productos.sql
alter table producto add column categoria varchar(40) not null default 'accesorios'; update producto set categoria = 'teclados' where nombre like 'Teclado%';
V2__agregar_categoria.sql
Y le decimos a Hibernate que ya no cree nada, solo que revise que las tablas coincidan con las entidades:
spring.jpa.hibernate.ddl-auto=validate
Al arrancar
registro de la aplicación2026-11-22T10:36:36.937-06:00 INFO 97 --- [catalogo] [ main] org.flywaydb.core.FlywayExecutor : Database: jdbc:h2:mem:16454b39-2e48-49ce-9193-872eba8ed30f (H2 2.5) 2026-11-22T10:36:36.977-06:00 WARN 97 --- [catalogo] [ main] o.f.c.internal.database.base.Database : Using H2 2.5.252 which is newer than the version Flyway has been verified with. The latest verified version of H2 is 2.3.232. 2026-11-22T10:36:36.994-06:00 INFO 97 --- [catalogo] [ main] o.f.c.i.s.JdbcTableSchemaHistory : Schema history table "PUBLIC"."flyway_schema_history" does not exist yet 2026-11-22T10:36:36.996-06:00 INFO 97 --- [catalogo] [ main] o.f.core.internal.command.DbValidate : Successfully validated 2 migrations (execution time 00:00.009s) 2026-11-22T10:36:37.002-06:00 INFO 97 --- [catalogo] [ main] o.f.c.i.s.JdbcTableSchemaHistory : Creating Schema History table "PUBLIC"."flyway_schema_history" ... 2026-11-22T10:36:37.027-06:00 INFO 97 --- [catalogo] [ main] o.f.core.internal.command.DbMigrate : Current version of schema "PUBLIC": << Empty Schema >> 2026-11-22T10:36:37.031-06:00 INFO 97 --- [catalogo] [ main] o.f.core.internal.command.DbMigrate : Migrating schema "PUBLIC" to version "1 - crear productos" 2026-11-22T10:36:37.043-06:00 INFO 97 --- [catalogo] [ main] o.f.core.internal.command.DbMigrate : Migrating schema "PUBLIC" to version "2 - agregar categoria" 2026-11-22T10:36:37.055-06:00 INFO 97 --- [catalogo] [ main] o.f.core.internal.command.DbMigrate : Successfully applied 2 migrations to schema "PUBLIC", now at version v2 (execution time 00:00.012s)
terminal$ curl -s localhost:8080/productos; echo
[{"categoria":"teclados","id":1,"nombre":"Teclado mecánico","precio":1299.00},{"categoria":"accesorios","id":2,"nombre":"Mouse inalámbrico","precio":349.50}]Flyway vio que la base estaba vacía, creó su tabla de control, flyway_schema_history, aplicó las dos migraciones en orden y anotó cada una. La advertencia solo dice que esta versión de H2 es más nueva que la última con la que Flyway se probó; las migraciones se aplicaron bien. En el siguiente arranque contra la misma base, vería que ya está en la versión 2 y no haría nada. Para agregar otra columna mañana, escribes V3__…; nunca cambias una migración ya aplicada, porque Flyway guarda una suma de verificación de cada una y se niega a arrancar si el archivo cambió.
Si la entidad no coincide con la base
Con ddl-auto=validate, una entidad que espera una columna que ninguna migración creó detiene el arranque. Quitamos la V2 y dejamos la entidad con categoria:
registro: la aplicación no arranca (fragmento)…Schema validation: missing column [categoria] in table [producto]
Es justo lo que quieres: el error aparece al desplegar, y no la primera vez que alguien consulta un producto.
Cada proyecto de esta página se compiló con Spring Boot 4.2.0, Java 25 (Temurin 25.0.5.1) y Maven 3.10.1 en un contenedor limpio y sin red, se arrancó y se probó con las peticiones de curl que ves; las respuestas y los registros están copiados de esa ejecución.