AutoConfigureWireMock missing in 5.0.0

[Hansanto]

Describe the bug
Hello

I'm upgrading my app dependencies to move on:

• Spring Boot 4.0.1
• Spring cloud dependencies 2025.1.0

And when I'm using the dependency org.springframework.cloud:spring-cloud-contract-wiremock (imported with 5.0.0 as version), the annotation org.springframework.cloud.contract.wiremock.AutoConfigureWireMock is missing.

However, with version 4.3.1, the annotation is present.

For version 5+, is there an equivalent of AutoConfigureWireMock to simply configure our tests?

[Hansanto]

For people searching: #2289

[marcingrzejszczak]

Yes, we removed the support in favour of the official WireMock's Spring Boot integration

[KnightKenobi]

Thanks for the clarification.

However, in practice this change creates a gap for WebFlux-based applications, especially Spring Cloud Gateway.

In Spring Cloud Contract 4.x, @AutoConfigureWireMock was effectively the only simple and reliable way to:

• start WireMock inside the Spring Test lifecycle
• expose it as a Spring-managed component
• work correctly with WebFlux / reactive stack
• avoid lifecycle and threading issues (Netty vs blocking servers)

With 5.x, the recommendation is to use the official WireMock Spring Boot integration.
Unfortunately, that integration:

• is primarily designed for Spring MVC
• relies on servlet-based infrastructure
• does not integrate cleanly with WebFlux / Gateway
• frequently leads to context hangs or startup issues in reactive tests

As a result, removing @AutoConfigureWireMock effectively removes the only out-of-the-box, reactive-safe solution for configuring WireMock in Spring Cloud Gateway tests.

At the moment, there is no direct equivalent in 5.x that:

• is Spring-managed,
• reactive-friendly,
• and requires minimal boilerplate for tests.

This forces users to:

• manually create WireMockServer beans,
• manage lifecycle themselves,
• or rely on ad-hoc workarounds (static ports, system properties, manual start/stop),

which is a regression compared to the 4.x testing experience.

Summary

• @AutoConfigureWireMock was not just convenience —
  it was a crucial integration point for WebFlux
• The official WireMock Spring Boot integration is not a drop-in replacement for reactive applications
• For Spring Cloud Gateway users, the removal significantly complicates integration testing

It would be very helpful to either:

• restore an equivalent reactive-safe test annotation, or
• clearly document a supported alternative specifically for WebFlux / Gateway.

[marcingrzejszczak]

Can you provide a reproducer? From what I remember you could run WireMock with Boot in standalone version, then it wouldn't matter whether you're working with Webflux or not. If I'm mistaken then we could file an issue (and try to fix it) in WireMock's Spring Boot support

cc @maciejwalkowiak

[maciejwalkowiak]

For the record, the official Wiremock integration for Spring Boot can be found nowadays here: https://github.com/wiremock/wiremock-spring-boot - I would recommend reporting an issue in that repository together with a sample project that reproduces it.

As far as I remember the initial implementation I made did not have anything Spring MVC or Webflux specific as it was just a convenient way to start Wiremock servers and propagate base urls to proper configuration properties in Spring context.

[rodrigorodrigues]

It would help if they add this new Wiremock-spring-boot on Spring Initializr, right now is showing only contract stub

[marcingrzejszczak]

@mhalbritter WDYT? ☝️

[mhalbritter]

Sure, please open an issue on https://github.com/spring-io/start.spring.io/issues (there's a template for new entries) and we can take a look.