Skip to content

文档:明确说明 wx-java-cp-multi-spring-boot-starter 中 corp-secret 的配置方式#3957

Draft
Copilot wants to merge 2 commits intodevelopfrom
copilot/fix-wx-java-cp-multi-spring-boot-secret
Draft

文档:明确说明 wx-java-cp-multi-spring-boot-starter 中 corp-secret 的配置方式#3957
Copilot wants to merge 2 commits intodevelopfrom
copilot/fix-wx-java-cp-multi-spring-boot-secret

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 7, 2026

企业微信不同功能模块使用不同的 Secret,每种 Secret 仅对对应模块的接口有权限。现有文档未说明这一机制,导致用户困惑:自建应用 Secret 无法更新部门,通讯录同步 Secret 调用应用接口报错。

变更内容

README(Spring Boot Starter + Solon 插件)

  • 新增"关于 corp-secret 的说明"章节,表格列出各类 Secret 的用途、获取位置及是否需要 agent-id
  • 配置示例同时展示自建应用条目(含 agent-id)与通讯录同步条目(不填 agent-id)的共存写法
  • 代码示例演示通过不同 tenantId 分别调用两种 Secret 对应的服务

WxCpSingleProperties Javadoc

  • corpSecret 字段注释说明各 Secret 类型及其 agentId 要求
  • agentId 字段注释说明自建应用必填、通讯录同步无需填写

AbstractWxCpConfiguration 代码注释

  • agentId 唯一性校验处增加注释,说明同一 corpId 下可配置多条目以使用不同 Secret 的设计意图

配置示例

# 自建应用:需填 agent-id
wx.cp.corps.app1.corp-id = xxx
wx.cp.corps.app1.corp-secret = <自建应用Secret>
wx.cp.corps.app1.agent-id = 1000001

# 通讯录同步:不需要 agent-id
wx.cp.corps.contact.corp-id = xxx
wx.cp.corps.contact.corp-secret = <通讯录同步Secret>
// 自建应用接口
wxCpMultiServices.getWxCpService("app1").getUserService().getUserId("xxx");

// 通讯录管理接口(部门增删改查)
wxCpMultiServices.getWxCpService("contact").getDepartmentService().update(dept);

- 增加 corp-secret 类型说明章节(自建应用/通讯录同步/客户联系)
- 更新配置示例展示多种 Secret 同时使用的方式
- 改善 WxCpSingleProperties 的 Javadoc
- 在 AbstractWxCpConfiguration 中增加设计意图注释

Agent-Logs-Url: https://github.com/binarywang/WxJava/sessions/c3b71887-e0c8-4297-b740-a39dc15c7d69

Co-authored-by: binarywang <1343140+binarywang@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix crop-secret usage for wx-java-cp-multi-spring-boot-starter 文档:明确说明 wx-java-cp-multi-spring-boot-starter 中 corp-secret 的配置方式 Apr 7, 2026
Copilot AI requested a review from binarywang April 7, 2026 09:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

wx-java-cp-multi-spring-boot-starter的crop-secret是使用的哪个

2 participants