如何恢复STS4中Maven项目Attach Source的自动下载功能？

可能的配置问题及修复方法 #

1. 工作空间Maven依赖缓存损坏 #

• 修复步骤：
  • 关闭STS，找到当前工作空间下的 .metadata/.plugins/org.eclipse.m2e.core 目录，删除其中的缓存文件（比如nexus文件夹或本地缓存的依赖索引）。
  • 重启STS后，右键异常项目 → Maven → Update Project，勾选Force Update of Snapshots/Releases，点击确定让Maven重新同步依赖。

2. STS源码自动下载功能被禁用 #

• 修复步骤：
  • 打开STS的 Window → Preferences → Spring → Source Code Support。
  • 确保勾选了 Automatically download sources for Spring libraries，这个是STS专属的自动源码下载开关，和Maven全局的"Download Artifact Sources"选项无关。

3. 项目或工作空间级Maven配置被局部覆盖 #

• 排查与修复：
  • 检查项目的pom.xml，确认没有设置<maven.source.skip>true</maven.source.skip>这类禁用源码下载的属性，也没有给Spring依赖设置provided等特殊范围导致源码无法关联。
  • 检查工作空间的Maven用户配置（Window → Preferences → Maven → User Settings），确认指定的settings.xml中没有配置限制源码访问的镜像、仓库，或者设置了downloadSources=false的全局参数。

4. 工作空间元数据（Metadata）损坏 #

• 修复步骤：
  • 备份工作空间内的所有项目文件。
  • 删除工作空间根目录下的 .metadata 文件夹（这个文件夹存储STS的工作空间配置信息）。
  • 重启STS，重新导入之前备份的项目到该工作空间。

5. JDT（Java开发工具）相关配置异常 #

• 修复步骤：
  • 打开 Window → Preferences → Java → Editor → Content Assist → Advanced，确保Java Proposals和Spring Proposals选项都处于启用状态。
  • 检查 Window → Preferences → Java → Installed JREs，确认当前使用的JRE/JDK路径正确，没有损坏或版本不兼容的情况。

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