Maven wrapper on M1 mac: /META-INF/maven/org.apache.maven.wrapper/maven-wrapper/pom.properties not found

I'm rather new to Java and I'm facing an error that I just can't figure out! I'm using an M1 mac, OpenJDK@21 and Java 21.0.8 (Installed from Brew) and Quarkus 3.25.3. When I use quarkus to generate a new project using quarkus create and then run quarkus dev or ./mvnw quarkus:dev (or any ./mvnw command actually!) I face the following error:

Exception in thread "main" java.lang.IllegalStateException: /META-INF/maven/org.apache.maven.wrapper/maven-wrapper/pom.properties not found.
        at org.apache.maven.wrapper.MavenWrapperMain.wrapperVersion(MavenWrapperMain.java:126)
        at org.apache.maven.wrapper.MavenWrapperMain.main(MavenWrapperMain.java:64)

When I run jar tf .mvn/wrapper/maven-wrapper.jar | grep pom.properties, the file exists! META-INF/maven/org.apache.maven.wrapper/maven-wrapper/pom.properties

I can regenerate the wrapper using mvn wrapper:wrapper or mvn -N org.apache.maven.plugins:maven-wrapper-plugin:3.3.2:wrapper -Dmaven=3.9.11 and the error will be resolved but the same steps when done on a windows machine won't require regenerating the wrapper and works fine! Any ideas what's happening?

uname -a

Darwin MacBookPro 24.6.0 Darwin Kernel Version 24.6.0: Mon Jul 14 11:30:34 PDT 2025; root:xnu-11417.140.69~1/RELEASE_ARM64_T8103 arm64

java -version

openjdk 21.0.8 2025-07-15

Quarkus --version:

3.25.3

mvn --version:

Apache Maven 3.9.11

Solution

On macOS + Java 21, the Maven Wrapper JAR shipped by Quarkus CLI can’t always load its pom.properties due to case-sensitivity or quarantine attributes. Regenerating the wrapper with the latest plugin (maven-wrapper-plugin:3.3.2) should fix it permanently.

It’s a quirk with the Maven Wrapper JAR that Quarkus ships by default. On macOS + Java 21 (M1/ARM) the wrapper sometimes can’t read its own pom.properties, even though it’s inside the JAR. It works on Windows because NTFS is case-insensitive and doesn’t have macOS’s quarantine attributes.

In your case: run the regenerate command once, commit the updated .mvn + mvnw into your repo, and it should work consistently across both macOS and Windows.