<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.3.0</version>
</dependency>

m the Maven repository.

2. Build Automation

Maven replaces fragmented shell commands with a unified lifecycle. Each phase triggers dependent phases automatically, ensuring deterministic execution.

Instead of: javac Main.java

You simply run: mvn compile

To create a JAR: mvn package

3. Standard Project Structure

Maven enforces a predictable directory layout that aligns with IDE expectations and CI/CD tooling.

Example:

project-name/
│
├── src/
│   ├── main/
│   │   ├── java/
│   │   └── resources/
│   │
│   └── test/
│       └── java/
│
├── pom.xml

Enter fullscreen mode Exit fullscreen mode

4. What is pom.xml?

This is the heart of Maven.

POM = Project Object Model

It contains:

• project name
• dependencies
• plugins
• Java version
• build settings

Example:

<project xmlns="http://maven.apache.org/POM/4.0.0">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0</version>

    <dependencies>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.2.5</version>
        </dependency>

    </dependencies>

</project>

Enter fullscreen mode Exit fullscreen mode

5. Essential Maven Commands

Command	Purpose
mvn compile	Compiles code
mvn test	Runs tests
mvn package	Creates JAR/WAR
mvn clean	Deletes old build files
mvn install	Installs into local repository

Pitfall Guide

1. Transitive Dependency Conflicts: Maven resolves transitive dependencies automatically, but version mismatches can cause NoSuchMethodError at runtime. Best Practice: Run mvn dependency:tree to audit conflicts, and enforce strict versions using <dependencyManagement> in parent POMs.
2. Skipping mvn clean in CI/CD: Incremental builds leave stale .class files, causing phantom compilation errors or outdated resources. Best Practice: Always execute mvn clean package in automated pipelines to guarantee artifact purity.
3. Hardcoding Versions Across Modules: In multi-module projects, repeating <version> tags breaks consistency and complicates upgrades. Best Practice: Centralize versions in a parent POM using <dependencyManagement> and <pluginManagement>, then reference artifacts without versions in child modules.
4. Misusing <scope> Tags: Incorrect scope declarations (e.g., marking test dependencies as compile) bloat production JARs and expose test frameworks to runtime. Best Practice: Strictly align scopes: compile (default), provided (container-supplied), test (test phase only), runtime (execution only).
5. Ignoring Repository Resolution Order: Maven checks local repository → remote central → custom mirrors. Misconfigured settings.xml can cause silent fallbacks or slow builds. Best Practice: Configure corporate mirrors in settings.xml, pin critical dependencies to private artifact repositories (Nexus/Artifactory), and avoid relying on snapshot versions in production.
6. Overcomplicating pom.xml with Custom Plugins: Adding excessive or poorly configured plugins increases build time and maintenance overhead. Best Practice: Leverage Spring Boot's spring-boot-maven-plugin for packaging, and only introduce custom plugins when lifecycle phases cannot be satisfied by standard Maven plugins (maven-compiler-plugin, maven-surefire-plugin).

Deliverables

• Blueprint: Maven Lifecycle & Dependency Resolution Flowchart (PDF/Visio) mapping validate → compile → test → package → install → deploy phases with artifact generation checkpoints.
• Checklist: pom.xml Validation & Build Pipeline Readiness Checklist covering GAV consistency, scope alignment, plugin version pinning, test coverage thresholds, and CI/CD integration steps.
• Configuration Templates:
  • Production-ready Spring Boot pom.xml with dependency management, compiler configuration, and packaging plugin.
  • Enterprise settings.xml template with mirror configuration, proxy settings, and server authentication blocks.