Spring REST Docs中requestParameters找不到符号问题求助

问题重现 #

在测试代码中使用以下静态导入时出现编译错误：

import static org.springframework.restdocs.request.RequestDocumentation.requestParameters;

错误信息：

java: cannot find symbol
  symbol:   static requestParameters
  location: class org.springframework.restdocs.request.RequestDocumentation

已尝试的无效操作：

• 检查并添加spring-restdocs-mockmvc依赖，清理Gradle/Maven缓存后重新下载
• 在IDE中刷新Gradle/Maven项目
• 重启IDE
• 确认Spring REST Docs版本与Spring Boot兼容

可行的解决方向 #

1. 确认依赖范围与完整性 #

确保依赖被正确添加到测试范围：

• Maven配置：

<dependency>
    <groupId>org.springframework.restdocs</groupId>
    <artifactId>spring-restdocs-mockmvc</artifactId>
    <scope>test</scope>
</dependency>

• Gradle配置：

testImplementation 'org.springframework.restdocs:spring-restdocs-mockmvc'

2. 排查依赖版本冲突 #

使用命令检查依赖树，确认是否存在多版本Spring REST Docs冲突：

• Gradle：

./gradlew dependencyInsight --dependency org.springframework.restdocs:spring-restdocs-mockmvc

• Maven：

mvn dependency:tree -Dincludes=org.springframework.restdocs

若发现冲突，在依赖中排除旧版本：

• Maven示例：

<dependency>
    <groupId>xxx</groupId>
    <artifactId>xxx</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.restdocs</groupId>
            <artifactId>spring-restdocs-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 彻底清理IDE缓存 #

执行更彻底的缓存清理：

• IntelliJ IDEA：File > Invalidate Caches...，勾选"Clear file system cache and local history"后重启
• Eclipse：Project > Clean，选择项目后执行清理

4. 验证JDK版本兼容性 #

Spring REST Docs 3.x及以上要求JDK 17+，Spring Boot 3.x也需配套JDK 17+，若使用JDK 8需降级到REST Docs 2.x版本。

5. 检查类导入是否存在干扰 #

确认项目中没有自定义的RequestDocumentation类，避免与Spring REST Docs的类重名导致导入错误。

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