Bug日志编号：[Maven-001]

标题：Windows系统下Maven项目因路径过长导致命令行执行失败

1. 问题描述

• 现象：执行mvn clean install时报错：
  The input line is too long 或 The filename or extension is too long
• 触发条件：
  • Windows系统
  • 项目依赖过多，生成的类路径（classpath）超过命令行字符限制
• 影响范围：所有需要长命令行操作的Maven命令（如测试、打包）

---

2. 环境信息

• 操作系统：Windows 11
• Maven版本：3.8.6
• JDK版本：17
• 复现频率：100%（依赖量大的项目）

---

3. 技术细节

• 错误本质：Windows命令行单条最大长度限制（默认8191字符，但受环境变量影响可能更低）
• 相关文件：target/classpath.txt（自动生成的类路径文件）
• 关键日志：

  [ERROR] Failed to execute goal ...  
  The command line is too long...
  

---

4. 根因分析

• 直接原因：Maven生成的类路径字符串超过Windows命令行限制
• 深层原因：
  • 项目依赖层级过深
  • Maven本地仓库路径较长（默认在用户目录）
  • 未启用Windows长路径支持

---

6. 解决方案（任选其一）

方案1：使用类路径文件引用（推荐）

<!-- pom.xml 添加配置 -->
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-dependency-plugin</artifactId>
      <executions>
        <execution>
          <id>build-classpath</id>
          <phase>generate-sources</phase>
          <goals>
            <goal>build-classpath</goal>
          </goals>
          <configuration>
            <outputFile>${project.build.directory}/classpath.txt</outputFile>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

方案2：缩短本地仓库路径

<!-- settings.xml 修改本地仓库位置 -->
<settings>
  <localRepository>C:/.m2/repository</localRepository>
</settings>

方案3：启用Windows长路径支持

1. 按Win+R输入gpedit.msc
2. 导航到：
   计算机配置 > 管理模板 > 系统 > 文件系统
3. 启用：
   启用 Win32 长路径