Troubleshooting

https://maven.apache.org/guides/
https://maven.apache.org/plugins/maven-help-plugin/
https://maven.apache.org/plugins/maven-dependency-plugin/

./mvnw -X clean test
./mvnw help:effective-pom
./mvnw help:effective-settings
./mvnw help:active-profiles
./mvnw dependency:tree

symptom:
    Non-resolvable parent POM

check:
    parent version
    relativePath
    repository URL
    settings.xml mirror and credentials

./mvnw dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind
./mvnw help:effective-pom

fix:
    check dependencyManagement
    check imported BOM order
    override vulnerable transitive dependency only after compatibility review

check:
    plugin is under build/plugins, not only pluginManagement
    execution has correct phase
    profile that contains plugin is active

./mvnw help:active-profiles
./mvnw -Pprod help:active-profiles

fix:
    pass -Pprofile-id
    check activation conditions
    distinguish Maven profile from Spring profile

check:
    -DskipTests
    -Dmaven.test.skip=true
    surefire includes/excludes
    test class naming pattern

check:
    server id matches repository id
    CI secret is present
    token permission includes read or deploy
    settings.xml is actually used with -s

symptom:
    PKIX path building failed

fix:
    import company CA into truststore
    pass truststore in MAVEN_OPTS
    do not disable certificate validation

check:
    CI cache for ~/.m2/repository
    dependency:go-offline in Docker build
    repeated clean usage
    slow integration tests in local default build

./mvnw -v
java -version

fix:
    set maven.compiler.release
    use toolchains when build JDK differs from runtime JDK
    enforce version with maven-enforcer-plugin