1. No usar una estructura de paquetes adecuada

Muchos principiantes colocan controladores, servicios y entidades en un mismo paquete. Spring Boot recomienda una estructura clara basada en capas: controller, service, repository, config.

2. No usar interfaces para la capa de servicio

Las interfaces permiten desacoplar servicios, aplicar pruebas unitarias y escalar el proyecto más fácilmente.

public interface UserService {
    UserDTO findById(Long id);
}

@Service
public class UserServiceImpl implements UserService {
@Override
public UserDTO findById(Long id) {
// lógica de negocio
return null;
}
}

3. Cargar demasiada lógica en los controladores

El controlador solo debe manejar peticiones HTTP. La lógica de negocio pertenece al servicio.

4. No validar entradas del usuario

La validación evita datos corruptos o errores inesperados. Usa @Valid y anotaciones como @NotNull, @Size o @Email.

5. Usar entidades JPA directamente como DTO

Esto acopla la capa de persistencia con la API. Lo correcto es mapear entidades a DTOs.

6. No manejar excepciones globalmente

Sin un manejador global, cada error lanza un stacktrace desordenado al usuario. Usa @ControllerAdvice.

7. No configurar logs adecuadamente

Los logs permiten depurar y entender el comportamiento del sistema. Usa niveles como INFO, DEBUG, WARN y ERROR.

8. No usar perfiles de entorno

Es un error común usar el mismo archivo application.properties para dev y producción. Spring Boot soporta application-dev y application-prod.

9. Ignorar dependencias innecesarias

Agregar starters sin necesidad aumenta el peso del proyecto y puede generar conflictos.

10. No usar transacciones correctamente

Spring Boot facilita el manejo transaccional con @Transactional. No usarlo puede causar inconsistencias en la BD.