如何直接修改已存在Maven包版本（从1.2.3-alpha到1.2.3-release）无需重构建？

Short answer: No, you can’t directly alter the version of an already published Maven package. Here’s why and what you should do instead:

Why Direct Modification Isn’t Allowed #

Maven repositories (whether public like Maven Central or private internal ones) are built on the principle of immutability for published artifacts. Once a package with a specific version (like 1.2.3-alpha) is pushed to a repo, it’s meant to stay exactly as it is. This guarantees that any project relying on 1.2.3-alpha will always pull the exact same code, preventing unexpected breaks from tampered or overwritten versions.

Trying to modify an existing version can cause:

• Cache inconsistencies across machines or build systems (some environments might still pull the old alpha version from local caches)
• Broken builds for downstream projects that already depend on the original 1.2.3-alpha
• Violations of standard repository policies (most public repos explicitly block overwriting existing versions)

The Correct Workflow #

When your tests pass and you’re ready for a stable release:

1. Update your project’s pom.xml to change the version from 1.2.3-alpha to 1.2.3 (note: release is usually redundant for stable versions—most projects use plain version numbers for production-ready releases).
2. Run a full rebuild to ensure all artifacts are generated with the new version:

   mvn clean install
   

3. Publish the new 1.2.3 version to your Maven repository using the deploy command:

   mvn deploy
   

4. (Optional) If you don’t want users to adopt the 1.2.3-alpha version anymore, mark it as deprecated in your repository (check your repo’s documentation for how to do this) or add a deprecation note in your project’s README. Avoid deleting the alpha version entirely—there might already be projects relying on it.

Quick Versioning Tip #

Sticking to Maven’s standard conventions helps avoid confusion:

• Use suffixes like -alpha, -beta, -SNAPSHOT for pre-release/unstable builds
• Reserve plain version numbers (like 1.2.3) for stable, production-ready releases

内容的提问来源于stack exchange，提问作者Little Bird