Mapa de entidades
La página Entities Map comprueba el mapeo JPA de cada entidad de una instancia de Spring Boot y muestra las asociaciones cuyo mapeo provoca consultas adicionales: carga anticipada, @ManyToMany respaldadas por List, cascadas REMOVE o ALL y @OneToMany unidireccionales.

Entities Map tal como aparece en la interfaz de Axelix
Los errores en el mapeo de asociaciones JPA no impiden que la aplicación funcione. En cambio, provocan consultas y cargas adicionales cada vez que se utiliza la entidad, y es fácil pasarlos por alto en una revisión de código. Entities Map comprueba el mapeo de todas las entidades y muestra dónde están esos errores.
La página es de solo lectura y está disponible para cualquier usuario autenticado: VIEWER, EDITOR, ADMIN y SUPER_ADMIN pueden abrirla. Consulte Roles y permisos para ver la matriz completa de roles y permisos.
Qué muestra la página
Un resumen en la parte superior indica cuántas entidades mapea la instancia, cuántas tienen problemas y cuántas no. Debajo se enumeran las entidades con problemas.
Despliegue una entidad para ver:
- El nombre de la tabla de
@Table, o el nombre de la entidad cuando@Tableno establece ninguno. - Cada asociación problemática, por ejemplo
Owner.pets, con sus problemas. - El mapeo de la asociación con los valores efectivos, incluidos los predeterminados, por ejemplo
@OneToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL) @JoinColumn(name = "owner_id") List<Pet>.
Si ninguna entidad tiene problemas, la página lo indica en lugar de mostrar la lista.
Problemas detectados
- EAGER fetching: la asociación se carga cada vez que se lee la entidad, se utilicen o no los datos. Esto incluye
@ManyToOney@OneToOnesin unfetchexplícito, ya que JPA utiliza carga anticipada de forma predeterminada para ellas. - List for @ManyToMany: una
@ManyToManyrespaldada por unaListhace que Hibernate vacíe y vuelva a insertar toda la tabla de unión ante cualquier cambio. - Bad CascadeType: en una
@OneToManyo@ManyToMany,CascadeType.REMOVEoCascadeType.ALLhace que Hibernate elimine los registros relacionados uno a uno, lo que genera consultas N+1. - Unidirectional @OneToMany: una
@OneToManysinmappedBynecesita una tabla de unión adicional o unUPDATEindependiente para cada registro.
Cómo funciona
Axelix Spring Boot Starter lee el metamodelo JPA de la aplicación y comprueba cada asociación. A diferencia de Transaction Control, el resultado no depende del tráfico: Axelix comprueba cómo se mapean las entidades, no qué consultas se han ejecutado. La página requiere Hibernate en la aplicación.
Herramientas MCP
Los agentes de IA pueden obtener mediante MCP las entidades y sus problemas de mapeo, tanto de toda la aplicación como de una entidad. Consulte el catálogo de herramientas MCP.
Propiedades
Entities Map funciona junto con la monitorización de transacciones y está activado de forma predeterminada. Para desactivarlo, establezca axelix.sbs.transaction.monitoring.enabled=false. Consulte Monitorización de transacciones para más información.
Entities Map no está disponible en aplicaciones reactivas (WebFlux), porque la monitorización de transacciones no se ejecuta en ellas. Consulte Aplicaciones reactivas (WebFlux).
Véase también
Control de transacciones
La página Transaction Control detecta métodos @Transactional que mantienen ocupada una conexión de base de datos más tiempo del necesario: llamadas de red bloqueantes, consultas N+1 y paginación en memoria dentro de la transacción. Para cada problema muestra dónde ocurre, para localizar el punto en el código.
Volcado de hilos
La página Thread Dump muestra una instantánea en directo de todos los hilos de la instancia gestionada de Spring Boot. Consulta la instancia periódicamente, por lo que la lista, los estados de los hilos y la línea temporal reflejan el estado reciente de la JVM y no una captura estática.