diff --git a/docs/HTTPCLIENT_UPGRADE_GUIDE.md b/docs/HTTPCLIENT_UPGRADE_GUIDE.md
index 945341966..5cabb1067 100644
--- a/docs/HTTPCLIENT_UPGRADE_GUIDE.md
+++ b/docs/HTTPCLIENT_UPGRADE_GUIDE.md
@@ -43,8 +43,8 @@
### 对现有项目
- **向后兼容**:不需要修改任何代码
-- HttpClient 4.x 依然可用,项目同时包含两个版本的依赖
-- 如果希望继续使用 HttpClient 4.x,只需在配置中显式指定
+- 如果希望继续使用 HttpClient 4.x,只需在配置中显式指定,pay 模块会自动包含 httpclient4 依赖(因为某些接口必须使用 httpclient4)
+ 其他模块(mp、miniapp、cp、open、channel、qidian)如果需要使用 httpclient4,必须显式在项目中添加 httpclient4 依赖
## 迁移步骤
@@ -94,10 +94,10 @@ WxMpService wxMpService = new WxMpServiceHttpClientImpl();
A: 不会。项目保持完全向后兼容,HttpClient 4.x 的所有实现都保持不变。
### Q: 我需要修改代码吗?
-A: 大多数情况下不需要。如果希望继续使用 HttpClient 4.x,只需在配置中指定 `http-client-type=HttpClient` 即可。
+A: 大多数情况下不需要。如果希望继续使用 HttpClient 4.x,只需在配置中指定 `http-client-type=HttpClient` ,并引入 HttpClient 4.x 依赖即可。
### Q: 我可以在同一个项目中同时使用两个版本吗?
-A: 可以。不同的模块可以配置使用不同的 HTTP 客户端。例如,MP 模块使用 HttpClient 5.x,MiniApp 模块默认使用 HttpClient 4.x,但也可以按需配置为 HttpClient 5.x。
+A: 可以。不同的模块可以配置使用不同的 HTTP 客户端。例如,MP 模块使用 HttpClient 5.x,pay 模块部分接口仍使用 HttpClient 4.x,但也可以按需配置为 HttpClient 5.x。
### Q: 如何排除不需要的依赖?
A: 如果只想使用一个版本,可以在 `pom.xml` 中排除另一个:
@@ -196,4 +196,4 @@ weixin-java-common/
- ✅ **推荐使用 HttpClient 5.x**:性能更好,功能更强
- ✅ **向后兼容**:可以继续使用 HttpClient 4.x
- ✅ **灵活配置**:支持多种 HTTP 客户端,按需选择
-- ✅ **平滑迁移**:无需修改代码,仅需配置即可
+- ✅ **平滑迁移**:无需修改代码,仅需配置,若不使用 HttpClient 5.x ,引入其他依赖即可
diff --git a/pom.xml b/pom.xml
index 5740a2779..d58a677b2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -136,7 +136,7 @@
UTF-8
4.5.13
- 5.5
+ 5.5.2
9.4.57.v20241219
diff --git a/weixin-java-channel/pom.xml b/weixin-java-channel/pom.xml
index 13dd26fa9..c15ea302e 100644
--- a/weixin-java-channel/pom.xml
+++ b/weixin-java-channel/pom.xml
@@ -29,6 +29,16 @@
jodd-http
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
+
+ org.apache.httpcomponents
+ httpmime
+ provided
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-common/pom.xml b/weixin-java-common/pom.xml
index 9032af97d..68826ca2d 100644
--- a/weixin-java-common/pom.xml
+++ b/weixin-java-common/pom.xml
@@ -34,6 +34,7 @@
org.apache.httpcomponents
httpclient
+ provided
commons-logging
@@ -44,6 +45,7 @@
org.apache.httpcomponents
httpmime
+ provided
diff --git a/weixin-java-cp/pom.xml b/weixin-java-cp/pom.xml
index 6c47176af..6f8ab756a 100644
--- a/weixin-java-cp/pom.xml
+++ b/weixin-java-cp/pom.xml
@@ -30,6 +30,11 @@
okhttp
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-miniapp/pom.xml b/weixin-java-miniapp/pom.xml
index 340a15e58..4f5378727 100644
--- a/weixin-java-miniapp/pom.xml
+++ b/weixin-java-miniapp/pom.xml
@@ -31,6 +31,16 @@
okhttp
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
+
+ org.apache.httpcomponents
+ httpmime
+ provided
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-mp/pom.xml b/weixin-java-mp/pom.xml
index c33aaeab8..755695d0c 100644
--- a/weixin-java-mp/pom.xml
+++ b/weixin-java-mp/pom.xml
@@ -31,6 +31,16 @@
okhttp
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
+
+ org.apache.httpcomponents
+ httpmime
+ provided
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-open/pom.xml b/weixin-java-open/pom.xml
index 4c34786da..6720cd2b3 100644
--- a/weixin-java-open/pom.xml
+++ b/weixin-java-open/pom.xml
@@ -48,6 +48,16 @@
okhttp
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
+
+ org.apache.httpcomponents
+ httpmime
+ provided
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-pay/pom.xml b/weixin-java-pay/pom.xml
index 9bf6d49a7..43851df85 100644
--- a/weixin-java-pay/pom.xml
+++ b/weixin-java-pay/pom.xml
@@ -34,6 +34,14 @@
jodd-util
6.1.0
+
+ org.apache.httpcomponents
+ httpclient
+
+
+ org.apache.httpcomponents
+ httpmime
+
org.apache.httpcomponents.client5
httpclient5
diff --git a/weixin-java-qidian/pom.xml b/weixin-java-qidian/pom.xml
index 293a4655c..0752ce69d 100644
--- a/weixin-java-qidian/pom.xml
+++ b/weixin-java-qidian/pom.xml
@@ -31,6 +31,11 @@
okhttp
provided
+
+ org.apache.httpcomponents
+ httpclient
+ provided
+
org.apache.httpcomponents.client5
httpclient5