在阅读Spring源码时，我们需要进行本地Debug来看看Spring的启动流程，在搭建Spring本地环境时，遇到许多坑，而且网上很多资料都不是最新的，导致花费了很多时间，下面分享下我的步骤。
本地环境配置
- MacBook M3
- Idea 2024.3.5
- Java8
- Gradle 5.6.4
1.配置Jdk8环境
- 下载jdk8
在Java官网下载适用于M芯片的jdk8版本，安装jdk。
- 配置Java环境变量
终端执行命令：vim ~/.bash_profile,修改文件内容。
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home
export PATH=$PATH:$JAVA_HOME/bin
保存文件，终端执行命令：source ~/.bash_profile使配置生效。
- 确保Java安装成功
终端执行命令：
java -version
如果输出以上内容，Java就安装成功。
2.下载Spring5.2.x源码
在GitHub下载Spring-5.2.x源码，解压到本地，查看源码中gradle/wrapper/gradle-wrapper.properties
可以看到Spring-5.2.x需要配置gradle5.6.4
3.配置Gradle环境
- 下载Gradle
在Gradle官网下载5.6.4版本gradle-5.6.4-bin.zip，解压到本地。
- 终端执行命令：
vim ~/.bash_profile，修改文件内容。
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-1.8.jdk/Contents/Home
export GRADLE_HOME=/Users/tyler/software/gradle-5.6.4
export PATH=$PATH:$GRADLE_HOME/bin:$JAVA_HOME/bin
保存文件，终端执行命令：source ~/.bash_profile使配置文件生效。
- 确保Gradle安装成功
终端执行命令：gradle -v
如果输出以上内容，Gradle就安装成功。
4.配置Spring5.2.x源码Debug环境
- 修改根目录下setting.gradle配置文件，在repositories配置项中新增阿里云仓库
- 修改根目录下build.gradle配置文件，在repositories配置项中新增阿里云仓库
- 预编译spring-oxm
在spring-framework-5.2.x根目标下，终端执行命令： gradle :spring-oxm:compileTestJava。
终端输出以上内容说明编译成功。
- Idea导入源码
打开Idea， 选择 File -> New -> Project from Existing Sources -> Navigate to directory -> Select build.gradle，导入源码。
- 新建spring-demo Module
可以新建测试类来调试跟踪Spring启动过程，在Debug时会发现Debug不生效，需要设置Idea Gradle配置。
- 设置Idea Gradle
5.编译Spring5.2.x源码可能遇到的问题
- Kotlin: warnings found and -Weeror specified
解决步骤：删除spring-core模块Kotlin -Weeror参数
如果还是不解决问题，在项目根目录下build.gradle配置文件中，找到allWarningsAsErrors，改为false。
- 找不到符号CoroutinesUtils
java: 找不到符号
符号: 变量 CoroutinesUtils
位置: 类 org.springframework.core.ReactiveAdapterRegistry.CoroutinesRegistrar
解决步骤：Idea File->Project Structure->Libraries->点击➕选择Java
选择Kotlin包依赖路径：spring-framework-5.2.x/spring-core/kotlin-coroutines/build/libs/kotlin-coroutines-5.2.26.BUILD-SNAPSHOT.jar
然后选择spring.spring-core.main。
成功之后可以看到Kotlin依赖。
如果还是报错，在Modules中，spring-core依赖中再添加一次，路径还是上面的。
- Java: 找不到符号 InstrumentationSavingAgent
解决步骤：修改spring-context.gradle，添加compile(project(":spring-instrument"))
- 找不到类
AnnotationTransactionAspect
解决步骤：在GitHub下载适合自己Java版本的aspectj依赖，双击安装，插件市场安装aspectj插件。
Project Settings选择Facets点击➕，选择AspectJ，选择spring.spring-aop.amin和spring.spring-aspects.main。
更改编译器
- ajc: GroovyDynamicElementReader cannot be resolved to a type
解决步骤：Java Compiler选择Delegate to Javac。
