Skip to content

Fix Spring Boot 4.0.0 compatibility - add Jackson 2 support module #418

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thomasturrell merged 6 commits into from
Nov 25, 2025
Merged

Fix Spring Boot 4.0.0 compatibility - add Jackson 2 support module #418

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
7883422
Initial plan
Copilot Nov 24, 2025
fd893af
Fix Spring Boot 4.0 autoconfiguration compatibility
Copilot Nov 24, 2025
396728e
Simplify WebClientTestConfiguration to avoid bean conflicts
Copilot Nov 24, 2025
15128cf
Changes before error encountered
Copilot Nov 24, 2025
0130305
Add spring-boot-jackson2 for Jackson 2 compatibility with Spring Boot…
Copilot Nov 24, 2025
def2178
Fix Jackson 2 property prefix in xapi-server sample test
Copilot Nov 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -272,6 +272,11 @@
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-jackson2</artifactId>
<version>4.0.0</version>
</dependency>
<dependency>
<groupId>dev.learning.xapi</groupId>
<artifactId>xapi-model</artifactId>
Expand Down
9 changes: 7 additions & 2 deletions samples/xapi-server/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,18 @@
</dependency>
<dependency>
<groupId>io.hypersistence</groupId>
<artifactId>hypersistence-utils-hibernate-60</artifactId>
<version>3.8.3</version>
<artifactId>hypersistence-utils-hibernate-70</artifactId>
<version>3.12.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-webmvc-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
</project>
4 changes: 2 additions & 2 deletions ...i-server/src/test/java/dev/learning/xapi/samples/xapiserver/StatementsControllerTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
import org.springframework.boot.webmvc.test.autoconfigure.WebMvcTest;
import org.springframework.http.MediaType;
import org.springframework.test.context.bean.override.mockito.MockitoBean;
import org.springframework.test.web.servlet.MockMvc;
Expand All @@ -25,7 +25,7 @@
*/
@WebMvcTest(
value = {StatementController.class},
properties = "spring.jackson.deserialization.ACCEPT_SINGLE_VALUE_AS_ARRAY = true")
properties = "spring.jackson2.deserialization.ACCEPT_SINGLE_VALUE_AS_ARRAY = true")
class StatementControllerTest {

@Autowired private MockMvc mvc;
Expand Down
10 changes: 10 additions & 0 deletions xapi-client/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,16 @@
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webflux</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jackson</artifactId>
Comment on lines 18 to +22
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Wrong exclusion keeps Jackson 3 in xapi-client

The webflux starter still pulls in Jackson 3 via spring-boot-starter-json, not spring-boot-starter-jackson, so this exclusion is a no-op. With the new spring-boot-jackson2 dependency in the same pom, Maven will still resolve the Jackson artifacts from the webflux starter (3.x), so the compatibility layer never takes effect and you end up running against Jackson 3—the very scenario this change is trying to avoid. Please exclude the actual JSON starter or override the Jackson BOM to 2.x so the classpath aligns with the compatibility module.

Useful? React with 👍 / 👎.

</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-jackson2</artifactId>
</dependency>
<dependency>
<groupId>dev.learning.xapi</groupId>
Expand Down
24 changes: 24 additions & 0 deletions ...ient/src/test/java/dev/learning/xapi/client/configuration/WebClientTestConfiguration.java
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
/*
* Copyright 2016-2025 Berry Cloud Ltd. All rights reserved.
*/

package dev.learning.xapi.client.configuration;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.client.WebClient;

/**
* Test configuration to provide WebClient.Builder bean for tests.
*
* <p>In Spring Boot 4.0, WebClient.Builder autoconfiguration was moved/removed. This configuration
* provides the bean for testing purposes.
*/
@Configuration
public class WebClientTestConfiguration {

@Bean
public WebClient.Builder webClientBuilder() {
return WebClient.builder();
}
}
11 changes: 7 additions & 4 deletions .../dev/learning/xapi/client/configuration/XapiClientAutoConfigurationAuthorizationTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration;
import org.springframework.boot.autoconfigure.web.reactive.function.client.WebClientAutoConfiguration;
import org.springframework.boot.http.codec.autoconfigure.CodecsAutoConfiguration;
import org.springframework.boot.jackson2.autoconfigure.Jackson2AutoConfiguration;
import org.springframework.boot.reactor.autoconfigure.ReactorAutoConfiguration;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.HttpHeaders;
import org.springframework.web.reactive.function.client.WebClient.Builder;
Expand All @@ -31,9 +32,11 @@
@SpringBootTest(
classes = {
XapiClientAutoConfiguration.class,
WebClientAutoConfiguration.class,
WebClientTestConfiguration.class,
CodecsAutoConfiguration.class,
ReactorAutoConfiguration.class,
XapiTestClientConfiguration2.class,
JacksonAutoConfiguration.class
Jackson2AutoConfiguration.class
},
properties = "xapi.client.authorization = bearer 1234")
class XapiClientAutoConfigurationAuthorizationTest {
Expand Down
11 changes: 7 additions & 4 deletions ...t/java/dev/learning/xapi/client/configuration/XapiClientAutoConfigurationBaseUrlTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,9 @@
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration;
import org.springframework.boot.autoconfigure.web.reactive.function.client.WebClientAutoConfiguration;
import org.springframework.boot.http.codec.autoconfigure.CodecsAutoConfiguration;
import org.springframework.boot.jackson2.autoconfigure.Jackson2AutoConfiguration;
import org.springframework.boot.reactor.autoconfigure.ReactorAutoConfiguration;
import org.springframework.boot.test.context.SpringBootTest;

/**
Expand All @@ -28,8 +29,10 @@
@SpringBootTest(
classes = {
XapiClientAutoConfiguration.class,
WebClientAutoConfiguration.class,
JacksonAutoConfiguration.class
WebClientTestConfiguration.class,
CodecsAutoConfiguration.class,
ReactorAutoConfiguration.class,
Jackson2AutoConfiguration.class
},
properties = {"xapi.client.baseUrl = http://127.0.0.1:55123/"})
class XapiClientAutoConfigurationBaseUrlTest {
Expand Down
11 changes: 7 additions & 4 deletions ...v/learning/xapi/client/configuration/XapiClientAutoConfigurationUsernamePasswordTest.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration;
import org.springframework.boot.autoconfigure.web.reactive.function.client.WebClientAutoConfiguration;
import org.springframework.boot.http.codec.autoconfigure.CodecsAutoConfiguration;
import org.springframework.boot.jackson2.autoconfigure.Jackson2AutoConfiguration;
import org.springframework.boot.reactor.autoconfigure.ReactorAutoConfiguration;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.HttpHeaders;
import org.springframework.web.reactive.function.client.WebClient.Builder;
Expand All @@ -31,9 +32,11 @@
@SpringBootTest(
classes = {
XapiClientAutoConfiguration.class,
WebClientAutoConfiguration.class,
WebClientTestConfiguration.class,
CodecsAutoConfiguration.class,
ReactorAutoConfiguration.class,
XapiTestClientConfiguration.class,
JacksonAutoConfiguration.class
Jackson2AutoConfiguration.class
},
properties = {"xapi.client.username = username", "xapi.client.password = password"})
class XapiClientAutoConfigurationUsernamePasswordTest {
Expand Down
10 changes: 10 additions & 0 deletions xapi-model-spring-boot-starter/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,16 @@
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jackson</artifactId>
Comment on lines 16 to +20
Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot Nov 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Wrong exclusion keeps Jackson 3 in model starter

Similar to the client module, spring-boot-starter-web depends on spring-boot-starter-json, not spring-boot-starter-jackson, so this exclusion does nothing. After adding spring-boot-jackson2, the project still resolves Jackson 3 from the web starter, meaning the compatibility module will not actually switch the application to Jackson 2 and you’ll run with the unsupported Jackson 3 API. Exclude the JSON starter or pin the Jackson BOM to 2.x to make the Jackson 2 compatibility effective.

Useful? React with 👍 / 👎.

</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-jackson2</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
Expand Down
6 changes: 3 additions & 3 deletions ...arter/src/main/java/dev/learning/xapi/autoconfigure/model/XapiModelAutoConfiguration.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,8 @@
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.boot.autoconfigure.AutoConfigureBefore;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer;
import org.springframework.boot.autoconfigure.jackson.JacksonProperties;
import org.springframework.boot.jackson2.autoconfigure.Jackson2ObjectMapperBuilderCustomizer;
import org.springframework.boot.jackson2.autoconfigure.Jackson2Properties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

Expand All @@ -40,7 +40,7 @@
* @author István Rátkai (Selindek)
*/
@Configuration
@AutoConfigureBefore(JacksonProperties.class)
@AutoConfigureBefore(Jackson2Properties.class)
public class XapiModelAutoConfiguration {

/**
Expand Down