[FLINK-40459][build] Bump Maven from 3.8.6 to 3.9.16 (#29009)

Updates the enforcer requireMavenVersion pin, wrapper distributionUrl/
checksum, and documented Maven version (README, AGENTS.md, docs) in
lock-step. Switches docs.sh to build via the Maven wrapper instead of
the CI image's system Maven, consistent with the rest of CI.

Maven 3.9 changed plugin execution logging from artifactId-based to
goal-prefix-based; flink-ci-tools' CI log parsers now accept both
forms.

Author: MartijnVisser

.github/workflows/docs.sh

@@ -23,7 +23,7 @@ set -e
 export JAVA_HOME=$JAVA_HOME_17_X64
 export PATH=$JAVA_HOME_17_X64/bin:$PATH
 
-mvn --version
+./mvnw --version
 java -version
 javadoc -J-version
 
@@ -62,11 +62,11 @@ ErrorDocument 404 /flink/flink-docs-${BRANCH}/404.html
 EOF
 
 # build Flink; required for Javadoc step
-mvn clean install -B -DskipTests -Dfast -Dskip.npm -Pskip-webui-build
+./mvnw clean install -B -DskipTests -Dfast -Dskip.npm -Pskip-webui-build
 
 # build java/scala docs
 mkdir -p docs/target/api
-mvn javadoc:aggregate -B \
+./mvnw javadoc:aggregate -B \
     -Pskip-webui-build \
     -Dmaven.javadoc.failOnError=true \
     -Dcheckstyle.skip=true \

.mvn/wrapper/maven-wrapper.properties

@@ -16,7 +16,7 @@
 # under the License.
 
 # updating the Maven version requires updates to certain documentation and verification logic
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.6/apache-maven-3.8.6-bin.zip
-distributionSha256Sum=ccf20a80e75a17ffc34d47c5c95c98c39d426ca17d670f09cd91e877072a9309
-wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.2/maven-wrapper-3.3.2.jar
-wrapperSha256Sum=3d8f20ce6103913be8b52aef6d994e0c54705fb527324ceb9b835b338739c7a8
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.16/apache-maven-3.9.16-bin.zip
+distributionSha256Sum=5af3b743dd8b876b5c45da33b676251e5f1687712644abb4ee519ca56e1d89ce
+wrapperUrl=https://repo.maven.apache.org/maven2/org/apache/maven/wrapper/maven-wrapper/3.3.4/maven-wrapper-3.3.4.jar
+wrapperSha256Sum=4e2fbf6554bc8a4702cdfdd3bef464f423393d784ddbb037216320ce55d5e4e1

AGENTS.md

@@ -24,7 +24,7 @@ This file provides guidance for AI coding agents working with the Apache Flink c
 ## Prerequisites
 
 - Java 11, 17 (default), or 21. Java 11 syntax must be used in all modules. Java 17 syntax (records, sealed classes, pattern matching) is only permitted in the `flink-tests-java17` module.
-- Maven 3.8.6 (Maven wrapper `./mvnw` included; prefer it)
+- Maven 3.9.16 (Maven wrapper `./mvnw` included; prefer it)
 - Git
 - Unix-like environment (Linux, macOS, WSL, Cygwin)
 

README.md

@@ -103,7 +103,7 @@ Prerequisites for building Flink:
 
 * Unix-like environment (we use Linux, Mac OS X, Cygwin, WSL)
 * Git
-* Maven (we require version 3.8.6)
+* Maven (we require version 3.9.16)
 * Java (version 11, 17, or 21)
 
 ### Basic Build Instructions

docs/content.zh/docs/dev/configuration/maven.md

@@ -28,7 +28,7 @@ under the License.
 
 ## 要求
 
-- Maven 3.8.6
+- Maven 3.9.16
 - Java 11
 
 ## 将项目导入 IDE

docs/content/docs/dev/configuration/maven.md

@@ -30,7 +30,7 @@ publish, and deploy projects. You can use it to manage the entire lifecycle of y
 
 ## Requirements
 
-- Maven 3.8.6
+- Maven 3.9.16
 - Java 11
 
 ## Importing the project into your IDE

mvnw

@@ -1879,7 +1879,7 @@ under the License.
 						<configuration>
 							<rules>
 								<requireMavenVersion>
-									<version>[3.8.6]</version>
+									<version>[3.9.16]</version>
 								</requireMavenVersion>
 								<requireJavaVersion>
 									<version>${target.java.version}</version>

mvnw.cmd

@@ -45,8 +45,11 @@ public class ScalaSuffixChecker {
     private static final Logger LOG = LoggerFactory.getLogger(ScalaSuffixChecker.class);
 
     // [INFO] --- maven-dependency-plugin:3.1.1:tree (default-cli) @ flink-annotations ---
+    // [INFO] --- dependency:3.1.1:tree (default-cli) @ flink-annotations ---
+    // Maven logs the plugin as "maven-dependency-plugin" up to 3.8 and as "dependency" (the goal
+    // prefix) from 3.9 on; both spellings are accepted so the parser works on either Maven version.
     private static final Pattern moduleNamePattern =
-            Pattern.compile(".* --- maven-dependency-plugin.* @ (.*) ---.*");
+            Pattern.compile(".* --- (?:maven-)?dependency(?:-plugin)?:.* @ (.*) ---.*");
 
     // [INFO] +- junit:junit:jar:4.13.2:test
     // [INFO] |  \- org.hamcrest:hamcrest-core:jar:1.3:test