Eclipse子运行时及m2e构建报错，求排查方案及操作影响

遇到的错误 #

子运行时启动错误 #

java.net.URISyntaxException: Illegal character in path at index 20: file:/C:/Users/Steve Vestal/.p2/pool/plugins/org.eclipse.m2e.maven.runtime_1.18.3.20220227-1319/jars/

注：该错误源于路径中的空格（Steve Vestal目录名包含空格），URI解析时无法识别未转义的空格字符。

父Eclipse m2e构建错误 #

Exception in thread "main" java.lang.NoClassDefFoundError: com/google/common/util/concurrent/internal/InternalFutureFailureAccess

注：该错误指向Guava类缺失或版本冲突，导致m2e构建时无法找到依赖类。

额外排查方法 #

• 迁移无空格路径：将Eclipse的p2池或工作空间迁移到无空格、无特殊字符的目录（如C:/Users/SteveVestal），彻底规避URI解析的空格问题。
• 清理m2e缓存：删除工作空间下的.metadata/.plugins/org.eclipse.m2e.core/nexus和.metadata/.plugins/org.eclipse.m2e.core/registry文件夹，重启Eclipse后重新初始化m2e配置。
• 排查Guava版本冲突：通过Help > About Eclipse > Installation Details > Plug-ins搜索guava，查看是否存在多版本Guava插件，卸载冲突版本，仅保留与当前m2e版本兼容的Guava插件。
• 替换为外部Maven运行时：在Window > Preferences > Maven > Installations中添加外部Maven并设为默认，绕开内置m2e运行时的路径和依赖问题。
• 刷新p2元数据：在Oomph专家模式下运行p2 > Reload Metadata，强制刷新p2仓库元数据，确保插件依赖解析正常。

关于删除.p2 m2e文件夹的疑问 #

删除该文件夹的影响 #

• 直接删除org.eclipse.m2e.maven.runtime_xxx/jars会导致Eclipse内置Maven运行时完全失效，启动子运行时或使用m2e构建时会抛出类/资源找不到的错误。
• 若后续通过Eclipse更新管理器重新安装m2e，p2会自动重新下载该文件夹下的jar包，恢复内置运行时功能，但需重新配置Maven相关设置。

外部Maven是否会替换被删除的文件 #

• 外部Maven与Eclipse的p2池完全独立，不会修改或替换.p2文件夹中的任何文件。外部Maven使用自身本地仓库（默认~/.m2/repository），和Eclipse内置m2e运行时无文件层面关联。
• 若在Eclipse中配置使用外部Maven作为默认运行时，即使删除内置m2e的jar包，依然可以正常构建，此时所有构建操作由外部Maven处理，不再依赖.p2中的内置运行时文件。

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