新增：微信支付多公众号关联配置支持 #3842

Copilot · 2026-01-09T06:22:55Z

用户需要在单个应用中为多个公众号配置微信支付服务。现有的 wx-java-pay-spring-boot-starter 仅支持单一配置。

实现

新增 wx-java-pay-multi-spring-boot-starter 模块，提供以下能力：

多配置管理：通过 WxPayMultiProperties 支持基于 Map 的多公众号配置
服务路由：WxPayMultiServices 接口根据 configKey 返回对应的 WxPayService 实例
懒加载 + 线程安全：使用 ConcurrentHashMap.computeIfAbsent() 实现按需创建和缓存
版本兼容：同时支持 V2、V3 和服务商模式配置

配置示例

wx:
  pay:
    configs:
      wx1111111111111111:  # 使用 appId 或自定义 key
        appId: wx1111111111111111
        mchId: 1234567890
        apiV3Key: xxxxx
        certSerialNo: xxxxx
        privateKeyPath: classpath:cert/app1/apiclient_key.pem
        privateCertPath: classpath:cert/app1/apiclient_cert.pem
      config2:  # 服务商模式
        appId: wx2222222222222222
        mchId: 9876543210
        subAppId: wx3333333333333333
        subMchId: 1111111111
        apiV3Key: yyyyy
        privateKeyPath: classpath:cert/app2/apiclient_key.pem

使用方式

@Autowired
private WxPayMultiServices wxPayMultiServices;

public void createOrder(String appId, String openId, Integer totalFee) {
    WxPayService wxPayService = wxPayMultiServices.getWxPayService(appId);
    // 使用 wxPayService 进行支付操作
}

结构

WxPayMultiProperties / WxPaySingleProperties：配置属性类
WxPayMultiServices / WxPayMultiServicesImpl：服务管理
WxPayMultiAutoConfiguration：Spring Boot 自动配置
单元测试和使用示例代码
完整的 README 文档

Original prompt

This section details on the original issue you should resolve

<issue_title>weixin-java-pay 如何配置多公众号关联</issue_title>
<issue_description>weixin-java-pay 如何配置多公众号关联</issue_description>

Comments on the Issue (you are @copilot in this section)

Custom agent used: 全部用中文
需要用中文，包括PR标题和分析总结过程

Fixes weixin-java-pay 如何配置多公众号关联 #3460

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: binarywang <[email protected]>

binarywang · 2026-01-09T07:12:40Z

auggie review

augmentcode · 2026-01-09T07:16:25Z

🤖 Augment PR Summary

总结：本 PR 为 wx-java-pay-spring-boot-starter 补充“多公众号/多商户配置”能力，满足单个应用需要按不同公众号（或服务商子商户）动态切换微信支付配置的诉求（关联问题：#3460）。

变更点：

在 spring-boot-starters 聚合工程中新增子模块：wx-java-pay-multi-spring-boot-starter
新增 WxPayMultiProperties，以 Map<String, WxPaySingleProperties> 形式承载多套支付配置（wx.pay.configs.*）
新增 WxPaySingleProperties，复用并覆盖 V2/V3/服务商模式所需的关键字段
新增 WxPayMultiServices / WxPayMultiServicesImpl，基于配置 key 获取对应的 WxPayService
服务实例采用 ConcurrentHashMap.computeIfAbsent 实现懒加载与缓存，避免一次性初始化全部配置
新增 WxPayMultiAutoConfiguration 及 META-INF/spring.factories，完成 Spring Boot 自动装配
增加单元测试，覆盖属性绑定、按 key 获取服务、实例复用与移除后重新创建等行为
补充 README 与示例代码，提供 V2/V3/服务商模式的配置与使用示例

技术说明：多配置通过 wx.pay.configs.<key>.* 组织，运行时按 key 路由到对应的 WxPayConfig/WxPayServiceImpl 实例，并支持通过 removeWxPayService 主动清理缓存以便重新加载配置。

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-01-09T07:16:26Z

...-starters/wx-java-pay-multi-spring-boot-starter/src/main/resources/META-INF/spring.factories

@@ -0,0 +1,2 @@
+org.springframework.boot.autoconfigure.EnableAutoConfiguration=\


该 starter 目前只注册了 spring.factories。仓库里其他 starter 通常还会同时提供 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports（Spring Boot 2.7+/3 的新机制）；否则在部分 Spring Boot 版本下可能无法被自动装配发现。

_{🤖 Was this useful? React with 👍 or 👎}

augmentcode · 2026-01-09T07:16:26Z

...r/src/main/java/com/binarywang/spring/starter/wxjava/pay/service/WxPayMultiServicesImpl.java

+
+  @Override
+  public void removeWxPayService(String configKey) {
+    services.remove(configKey);


这里直接 services.remove(configKey) 在 configKey 为 null 时会触发 NPE（ConcurrentHashMap 不接受 null key），而 getWxPayService 已对空值做了保护。建议 removeWxPayService 也做相同的输入校验以避免外部误传空值导致异常。

_{🤖 Was this useful? React with 👍 or 👎}

augmentcode

Review completed. 1 suggestions posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-01-09T07:17:02Z

...r/src/main/java/com/binarywang/spring/starter/wxjava/pay/service/WxPayMultiServicesImpl.java

+
+    // 使用 computeIfAbsent 实现线程安全的懒加载，避免使用 synchronized(this) 带来的性能问题
+    return services.computeIfAbsent(configKey, key -> {
+      WxPaySingleProperties properties = wxPayMultiProperties.getConfigs().get(key);


这里实际是通过 wxPayMultiProperties.getConfigs().get(key) 按 Map 的 key 查找配置；当配置 key 不是 appId 时，调用方传入 appId 会取不到服务（README/Javadoc 里“configKey 或 appId”容易误导）。建议明确入参语义只能是配置 key，或补充按 appId 反向匹配的逻辑。

_{🤖 Was this useful? React with 👍 or 👎}

Copilot

Pull request overview

本 Pull Request 新增了 wx-java-pay-multi-spring-boot-starter 模块，为 WxJava 项目提供微信支付多公众号关联配置支持。该功能允许开发者在单个应用中为多个公众号配置独立的微信支付服务，解决了服务商或多公众号系统的支付场景需求。

主要变更包括：

新增支持多配置的 Spring Boot Starter 模块，提供基于 Map 的配置管理
实现懒加载服务创建机制，通过 ConcurrentHashMap.computeIfAbsent() 保证线程安全
提供完整的配置示例、单元测试和使用文档

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
spring-boot-starters/pom.xml	在父 POM 中添加新模块 wx-java-pay-multi-spring-boot-starter
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/pom.xml	新模块的 Maven 配置，包含依赖和构建插件
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/java/com/binarywang/spring/starter/wxjava/pay/config/WxPayMultiAutoConfiguration.java	Spring Boot 自动配置类，负责注册多服务管理器
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/java/com/binarywang/spring/starter/wxjava/pay/properties/WxPayMultiProperties.java	多配置属性类，定义配置前缀和存储结构
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/java/com/binarywang/spring/starter/wxjava/pay/properties/WxPaySingleProperties.java	单个公众号配置属性类，包含所有微信支付相关配置项
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/java/com/binarywang/spring/starter/wxjava/pay/service/WxPayMultiServices.java	多服务管理接口，定义获取和移除服务方法
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/java/com/binarywang/spring/starter/wxjava/pay/service/WxPayMultiServicesImpl.java	多服务管理实现类，提供线程安全的懒加载服务创建
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/main/resources/META-INF/spring.factories	Spring Boot 自动配置注册文件
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/test/java/com/binarywang/spring/starter/wxjava/pay/WxPayMultiServicesTest.java	单元测试，验证配置加载和服务管理功能
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/src/test/java/com/binarywang/spring/starter/wxjava/pay/example/WxPayMultiExample.java	详细的使用示例代码，涵盖常见支付场景
spring-boot-starters/wx-java-pay-multi-spring-boot-starter/README.md	完整的使用文档，包含配置说明、示例和常见问题

Copilot · 2026-01-09T07:21:36Z

...arter/src/main/java/com/binarywang/spring/starter/wxjava/pay/service/WxPayMultiServices.java

+import com.github.binarywang.wxpay.service.WxPayService;
+
+/**
+ * 微信支付 {@link WxPayService} 所有实例存放类.


javadoc 注释不准确。此接口用于存放微信支付服务实例，而非企业微信。应改为"微信支付 {@link WxPayService} 所有实例存放类"而非"企业微信"。

Copilot · 2026-01-09T07:21:37Z

spring-boot-starters/wx-java-pay-multi-spring-boot-starter/README.md

+    }
+
+    // 查询订单
+    WxPayOrderQueryV3Result result = wxPayService.queryOrderV3(null, outTradeNo);


示例代码中使用了 WxPayOrderQueryV3Result 类型，但在导入语句中缺少对应的 import 声明。应在文件开头的 import 部分添加：import com.github.binarywang.wxpay.bean.result.WxPayOrderQueryV3Result;

Copilot AI assigned Copilot and binarywang Jan 9, 2026

Initial plan

7e18bde

Copilot started work on behalf of binarywang January 9, 2026 06:23 View session

Copilot AI and others added 3 commits January 9, 2026 06:32

新增：创建 wx-java-pay-multi-spring-boot-starter 模块支持多公众号关联配置

86ef11f

Co-authored-by: binarywang <[email protected]>

文档：添加多公众号关联使用示例代码

eaae169

Co-authored-by: binarywang <[email protected]>

修复：根据代码审查反馈优化实现

801a284

Co-authored-by: binarywang <[email protected]>

Copilot AI changed the title ~~[WIP] Add configuration for multiple Weixin accounts~~ 新增：微信支付多公众号关联配置支持 Jan 9, 2026

Copilot AI requested a review from binarywang January 9, 2026 06:42

Copilot finished work on behalf of binarywang January 9, 2026 06:42

binarywang marked this pull request as ready for review January 9, 2026 07:12

Copilot AI review requested due to automatic review settings January 9, 2026 07:12

Copilot started reviewing on behalf of binarywang January 9, 2026 07:13 View session

augmentcode bot reviewed Jan 9, 2026

View reviewed changes

Copilot AI reviewed Jan 9, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

新增：微信支付多公众号关联配置支持 #3842

新增：微信支付多公众号关联配置支持 #3842

Uh oh!

Copilot AI commented Jan 9, 2026 •

edited

Loading

Uh oh!

binarywang commented Jan 9, 2026

Uh oh!

augmentcode bot commented Jan 9, 2026 •

edited

Loading

Uh oh!

augmentcode bot left a comment

Uh oh!

augmentcode bot Jan 9, 2026

Uh oh!

augmentcode bot Jan 9, 2026

Uh oh!

augmentcode bot left a comment

Uh oh!

augmentcode bot Jan 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 9, 2026

Uh oh!

Copilot AI Jan 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -0,0 +1,2 @@
		org.springframework.boot.autoconfigure.EnableAutoConfiguration=\

Uh oh!

新增：微信支付多公众号关联配置支持 #3842

Are you sure you want to change the base?

新增：微信支付多公众号关联配置支持 #3842

Uh oh!

Conversation

Copilot AI commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

实现

配置示例

使用方式

结构

Comments on the Issue (you are @copilot in this section)

Uh oh!

binarywang commented Jan 9, 2026

Uh oh!

augmentcode bot commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

augmentcode bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

augmentcode bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Jan 9, 2026 •

edited

Loading

augmentcode bot commented Jan 9, 2026 •

edited

Loading