spring-boot-migration

This skill provides a comprehensive operational framework for upgrading Java applications from Spring Boot 2.x to 3.x. The transition represents a major architectural shift due to the move from Java EE to the Jakarta EE namespace, which frequently causes dependency conflicts and compilation failures. This skill is designed for software engineers, backend developers, and DevOps professionals managing legacy Java projects that require modernization to align with current Spring Framework standards, improved performance, and long-term security support.

• Automates the migration of parent POM versions from 2.7.x to 3.2.x and above.

• Updates project Java version requirements to Java 17 or 21, ensuring compatibility with modern LTS releases.

• Identifies and removes incompatible legacy dependencies, specifically the JAXB API, JAXB implementation, and javax.activation, which conflict with the new Jakarta EE implementation.

• Provides clear instructions for replacing deprecated libraries like the old jjwt with modern, modular versions.

• Offers guidance on addressing common runtime issues including H2 database dialect configuration changes and Actuator endpoint security path updates.

• Integrates with OpenRewrite recipes to facilitate automated bulk refactoring of source code.

• Users should input the path to their pom.xml file to receive precise commands for version updates and cleanup.

• Outputs provide executable shell commands for sed-based string replacement and manual verification steps for dependency conflict resolution.

• Practical constraints include the requirement for manual intervention when complex class name refactoring (from javax.* to jakarta.*) is needed.

• The skill helps resolve common build errors by verifying the classpath and ensuring that transitive dependencies do not include conflicting namespace versions.

• Recommended for use alongside version control systems to ensure that migration changes can be rolled back if runtime behavior changes occur due to the underlying framework shift.