Maven项目GitHub Actions构建报错：无法找到pom.xml文件

错误的核心原因是Linux系统的大小写敏感性，具体涉及两个环节：

• 你的项目中Maven配置文件是大写的POM.xml，但setup-java action的cache: maven选项默认会查找小写的pom.xml文件来生成缓存键。Linux环境下大小写不同会被识别为完全不同的文件，因此缓存步骤找不到匹配文件，触发报错。
• 虽然你在mvn命令里指定了--file POM.xml，但缓存步骤先执行失败，导致整个构建流程中断。

解决方法 #

推荐方案：遵循Maven命名规范

Maven官方标准要求使用小写的pom.xml作为项目配置文件名，直接将你的POM.xml重命名为pom.xml，同时修改GitHub Actions配置中的构建命令：

mvn clean test --file pom.xml

这样既符合行业规范，也能让setup-java的缓存功能正常运行。

备选方案：自定义缓存路径（不推荐）

如果因特殊需求必须保留POM.xml文件名，需要修改setup-java的配置，手动指定缓存路径，避免默认的小写文件查找：

- name: Set up JDK 20
  uses: actions/setup-java@v3
  with:
    java-version: '20'
    distribution: 'temurin'
    cache: 'maven'
    cache-path: 'POM.xml'

同时确保mvn命令中的文件名保持一致：

mvn clean test --file POM.xml

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