Missing starter for spring-boot-restdocs

[jnizet]

I can't find any starter listed in the migration guide, or in the reference guide, for spring-restdocs.

Using start.spring.io and selecting "Web" and "RestDocs" adds the following starters to the project dependencies:

  implementation("org.springframework.boot:spring-boot-starter-webmvc")
  
  testImplementation("org.springframework.boot:spring-boot-starter-webmvc-test")
  testImplementation("org.springframework.restdocs:spring-restdocs-mockmvc")

but the org.springframework.boot.restdocs.test.autoconfigure.AutoConfigureRestDocs annotation can't be found with these dependencies (even though it is documented and exists: https://docs.spring.io/spring-boot/api/java/org/springframework/boot/restdocs/test/autoconfigure/AutoConfigureRestDocs.html)

Am I missing something?

[wilkinsona]

That's an oversight with start.spring.io as we forgot to update its REST Docs support following Boot's modularization.

Not every module has a starter and that's the case here, for now at least. You can add a dependency on spring-boot-restdocs to use @AutoConfigureRestDocs.

[wilkinsona]

Once spring-io/start.spring.io#1996 has been deployed, start.spring.io will automatically add the spring-boot-restdocs dependency. I'll leave this open for now so that we can decide if we want to add spring-boot-starter-restdocs to Boot.

[jnizet]

Thank you @wilkinsona

[wimdeblauwe-volvo]

I just ran into this issue as well when updating a project to Spring Boot 4. Would be great if the migration guide could mention that you now need to add a dependency on org.springframework.boot:spring-boot-restdocs.