AddJaxwsRuntime recipe injects legacy JAX-WS 2.3 runtime on JAX-WS 4.0 / Jakarta projects, causing a dependency resolution conflict
维护者通常 1 天内回复
评估
- 难度
- 3/5
- 预计耗时
- 半天
- 新手友好度
- 40/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- java
- 领域
- build-system
调研方向
Start with the AddJaxwsRuntime recipe in the wsee package, which adds com.sun.xml.ws:jaxws-rt:2.3.7 with provided scope when JAX-WS or JAXB usages are found. Reproduce with a project that imports jakarta.xml.ws and jakarta.xml.soap and check the effective POM before and after the recipe runs. Done means the recipe either skips when Jakarta 4.x APIs are already declared or injects a compatible runtime, and the project compiles. The maintainers have not yet chosen between the two options in the issue.
由索引模型根据 Issue 内容生成。
描述
TL;DR The change results in a compile error
With 6.21.0 no changes were made. It was noticed with 6.49.0 and also exist in 6.50. Hence in the past I didn't need aan tag. Did some digging and got the AIto summarize the findings. See below.
Describe the bug
The org.openrewrite.java.migrate.wsee.AddJaxwsRuntime recipe injects the JAX-WS 2.3 runtime (com.sun.xml.ws:jaxws-rt:2.3.7) with provided scope when JAX-WS or JAXB API usages are detected.
While this recipe is intended to provide a JAX-WS runtime for environments running on Java 11+ (where JAX-WS was removed from the JDK), it introduces a dependency resolution conflict on modern projects that have already migrated to
JAX-WS 4.0 / Jakarta EE 9+ (e.g., Micronaut 4.x applications utilizing the jakarta.xml.ws.* namespace).
Comparing the Maven Effective POM before and after the recipe's modification reveals that injecting jaxws-rt:2.3.7 transitively pulls in legacy javax-based API jars under the jakarta GroupID (specifically
jakarta.xml.ws:jakarta.xml.ws-api:2.3.3 and jakarta.xml.soap:jakarta.xml.soap-api:1.4.2).
Because these legacy dependencies are introduced as transitive dependencies of a direct provided scope dependency (jaxws-rt:2.3.7), Maven's dependency resolution prioritizes them over the project's modern, compile-scope
jakarta.xml.ws-api:4.0.1 and jakarta.xml.soap-api:3.0.1 API jars. This downgrades the API jars to versions that lack the jakarta.* packages, resulting in compilation failures for hand-written source files that import jakarta.xml.ws.*
or jakarta.xml.soap.*.
The Technical Mechanism (Verified via Effective POM comparison)
A detailed comparison of the Maven Effective POM configurations (mvn help:effective-pom) before and after applying the recipe demonstrates the dependency resolution conflict:
- Before the recipe (effective-without.xml):
The project is running on Micronaut 4.x / Java 21, and successfully resolves the modern Jakarta XML Web Services 4.0 API:
1
2 jakarta.xml.ws
3 jakarta.xml.ws-api
4 4.0.1
5 compile
6
All source files import jakarta.xml.ws.* and jakarta.xml.soap.* and compile successfully as a compatible runtime (e.g., Apache CXF 4.x) is transitively present.
-
After the recipe (effective-with.xml):
The recipe injects com.sun.xml.ws:jaxws-rt:2.3.7 (implementing JAX-WS 2.3).
This runtime transitively depends on legacy API jars:- jakarta.xml.ws:jakarta.xml.ws-api:2.3.3 (containing the legacy
javax.namespace)* - jakarta.xml.soap:jakarta.xml.soap-api:1.4.2 (containing the legacy
javax.namespace)*
Maven's dependency resolution prioritizes these transitive paths under the provided scope, downgrading the compile-scope jakarta.xml.ws-api:4.0.1 and jakarta.xml.soap-api:3.0.1 API jars.
- jakarta.xml.ws:jakarta.xml.ws-api:2.3.3 (containing the legacy
-
Compilation Impact:
Because the legacy 2.3.3 and 1.4.2 API jars do not contain the jakarta namespace classes, the jakarta packages are no longer present on the compile classpath, causing compilation to fail.
Compiler Failure Output
1 [ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.16.0:compile (default-compile) on project sirivm-swarco-source: Compilation failure:
2 [ERROR] /src/main/java/.../SwarcoSiriVmXmlDecoderActor.java: package jakarta.xml.soap does not exist
3 [ERROR] /src/main/java/.../SwarcoSiriVmXmlDecoderActor.java: cannot find symbol: class SOAPMessage
4 [ERROR] /src/main/java/.../SwarcoSubscriberActor.java: package jakarta.xml.ws does not exist
5 [ERROR] /src/main/java/.../SwarcoSubscriberActor.java: cannot find symbol: class Holder
Suggested Resolution
The AddJaxwsRuntime recipe could benefit from namespace awareness and check for existing JAX-WS 4.x / JAXB 4.x declarations:
- Check existing API namespace: The recipe could check if jakarta.xml.ws-api (version 4.x+) is already declared and resolved, and skip execution if found.
- Compatible Runtime Injection: If a runtime must be added, the recipe should detect the active namespace. If jakarta.* is used, it should inject a compatible Jakarta XML Web Services 4.0 runtime (such as
com.sun.xml.ws:jaxws-rt:4.0.x) instead of the legacy javax-based 2.3.7 version.
Environment
- OpenRewrite Maven Plugin: 6.49.0
- Active Recipes: org.openrewrite.java.migrate.wsee.AddJaxwsRuntime
- Framework: Micronaut 4.x (latest iirc)
- Java Version: 21
1
- 主要语言
- Java
- 星标
- 159
- 派生
- 130
- 平均合并
- 7 小时 12 分钟
- 30 天内合并 PR
- 43
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
openrewrite/rewrite-migrate-java 的其他 Issue
-
难度 4/5 3-5 天 新手友好度 55/100
openrewrite/rewrite-migrate-java#1289 ·
维护者通常 1 天内回复
-
bug
难度 4/5 3-5 天 新手友好度 68/100
openrewrite/rewrite-migrate-java#1246 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 32/100
openrewrite/rewrite-migrate-java#1227 · 2 条评论 ·
维护者通常 1 天内回复
-
OptionalNotPresentToIsEmpty rewrites `!isPresent()` on a non-`java.util.Optional` type, producing uncompilable `isEmpty()`可能重新可做 关联的 PR 已关闭且未合并。 未关闭
难度 3/5 1-2 天 新手友好度 70/100
openrewrite/rewrite-migrate-java#1146 · 3 条评论 ·
维护者通常 1 天内回复
-
bug
难度 4/5 3-5 天 新手友好度 50/100
openrewrite/rewrite-migrate-java#1119 · 5 条评论 ·
维护者通常 1 天内回复
查看 openrewrite/rewrite-migrate-java 的全部 Issue
相似的 Issue
-
approved bug
难度 2/5 1-3 小时 新手友好度 70/100
checkstyle/checkstyle#21981 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
beehive-lab/TornadoVM#1248 ·
维护者通常 1 天内回复
-
good first issue help wanted ready-for-human
难度 2/5 半天 新手友好度 64/100
维护者通常 1 天内回复
-
bug jdbc-v2
难度 2/5 1-3 小时 新手友好度 70/100
ClickHouse/clickhouse-java#3214 ·
维护者通常 1 天内回复
-
area: detector eco: java help wanted lane: free-agent roadmap size: S type: parser
难度 2/5 1-3 小时 新手友好度 62/100
arminazimi/evergreen#355 ·
维护者通常 1 天内回复