Как подключить @AutoConfigureWebTestClient в Spring Boot 4

The annotation was never removed – it was moved out of the test starter and into the standalone test‑autoconfigure module that Spring Boot 4 now ships with.
Because test fixtures are compiled with a separate class‑path, they don’t see the transitive dependencies that spring‑boot‑starter‑test pulls in for your regular test sources.
Add the test‑autoconfigure module explicitly to the test‑fixtures configuration (use implementation, not compileOnly) and the @AutoConfigureWebTestClient annotation will be available.

Содержание

• Проблема и её причины
• Как Spring Boot 4.0 организует тестовые зависимости
• Правильное подключение в Gradle kts
• Проверка и пример использования
• Заключение

Проблема и её причины

@AutoConfigureWebTestClient — аннотация, которая находится в пакете
org.springframework.boot.test.autoconfigure.web.reactive.
В Spring Boot 4.0 этот пакет не входит в spring-boot-starter-test включительно;
он вынесен в отдельный артефакт spring-boot-test-autoconfigure.
Когда вы объявляете зависимость как testFixturesCompileOnly, Gradle не добавляет
перехватываемые транзитивные зависимости, поэтому аннотация остаётся
неразрешённой.

Как Spring Boot 4.0 организует тестовые зависимости

• spring-boot-starter-test содержит только общие тестовые библиотеки и
  сам spring-boot-test-autoconfigure как зависимость.
• spring-boot-test-autoconfigure содержит аннотации автоконфигурации,
  включая @AutoConfigureWebTestClient — https://docs.spring.io/spring-boot/docs/4.0.0.RELEASE/api/org/springframework/boot/test/autoconfigure/web/reactive/AutoConfigureWebTestClient.html.
• Для test‑fixtures Gradle требует явного указания зависимостей,
  которые должны попасть в их собственный class‑path
  (https://docs.gradle.org/current/userguide/java_testing.html#test-fixtures).

Правильное подключение в Gradle kts

plugins {
    `java-test-fixtures`
}

dependencies {
    // Основные тестовые зависимости – включают test‑autoconfigure
    testImplementation("org.springframework.boot:spring-boot-starter-test:4.0.0")

    // Добавляем test‑autoconfigure в test‑fixtures
    testFixturesImplementation("org.springframework.boot:spring-boot-test-autoconfigure:4.0.0")

    // (Опционально) Если нужен только WebClient‑специфический автоконфиг
    // testFixturesImplementation("org.springframework.boot:spring-boot-test-autoconfigure:webclient")
}

Важно – используйте implementation, а не compileOnly.
compileOnly подключает только сам модуль, но не его транзитивные зависимости,
которые в нашем случае необходимы для автоконфигурации.

Проверка и пример использования

1. Скомпилируйте проект – Gradle подтянет spring-boot-test-autoconfigure
   в class‑path testFixtures.

2. Создайте в src/testFixtures/kotlin файл:

   kotlin

   import org.springframework.boot.autoconfigure.EnableAutoConfiguration
   import org.springframework.boot.test.context.SpringBootTest
   import org.springframework.test.context.ActiveProfiles
   import org.springframework.boot.test.autoconfigure.web.reactive.AutoConfigureWebTestClient
   
   @SpringBootTest
   @EnableAutoConfiguration
   @AutoConfigureWebTestClient
   @ActiveProfiles("sandbox", "debug", "nodb")
   annotation class TestWithoutDb
   

3. В обычных тестах импортируйте TestWithoutDb из testFixtures и
   убедитесь, что WebTestClient автоматически создаётся и вы можете его использовать.

Заключение

• @AutoConfigureWebTestClient не исчезла в Spring Boot 4.0; она переместилась в spring-boot-test-autoconfigure.
• Для test‑fixtures подключайте этот артефакт как testFixturesImplementation.
• Не используйте compileOnly; иначе транзитивные зависимости (и сама аннотация) не будут доступны.
• После исправления build.gradle.kts вы сможете использовать
  @AutoConfigureWebTestClient в своих тестовых фикстурах без ошибок класса.

Если вы всё ещё видите ошибку, проверьте, что версия spring-boot-test-autoconfigure совпадает с версией Spring Boot 4.0.0, и очистите кэш Gradle (./gradlew clean build --refresh-dependencies).