fix: 支持长整型企业微信应用ID

[binarywang]

修改内容

• 将企业微信 agentId 的核心配置、Spring Boot 单账号/多账号属性及默认调用链由 Integer 调整为 Long。
• 支持配置超出 32 位整数范围的 wx.cp.agent-id，例如 1013699173317。
• 同步调整消息、菜单、OAuth 等依赖默认 agentId 的调用路径，并补充回归用例。

根因

Spring Boot 配置属性与 CP 核心配置均使用 Integer，导致超出 32 位范围的 agentId 在应用启动绑定配置时抛出 NumberFormatException。

影响

CP 模块 agentId 相关公开 API 改为 Long，属于不保持二进制兼容的类型调整。

验证

• mvn -pl weixin-java-cp -am -Dtest=WxCpDefaultConfigImplTest -Dsurefire.failIfNoSpecifiedTests=false test
• mvn -pl weixin-java-cp,spring-boot-starters/wx-java-cp-spring-boot-starter,spring-boot-starters/wx-java-cp-multi-spring-boot-starter -am -Dmaven.test.skip=true package

Closes #4077

[augmentcode]

🤖 Augment PR Summary

Summary: 本 PR 主要为企业微信（CP）应用 AgentId 增加对超出 Integer 范围的支持（使用 Long）。

Changes:

• 将 Spring Boot Starter（单账号/多账号）中的 agentId 配置类型由 Integer 调整为 Long
• 将 CP 核心配置接口 WxCpConfigStorage#getAgentId 返回类型调整为 Long，并同步更新默认/Redis/Redis-抽象实现
• 将部分 CP Service 接口与实现（Agent/Menu/OAuth2/CorpGroup 等）中入参 agentId 由 Integer 调整为 Long
• 将消息相关 Bean（WxCpMessage、WxCpLinkedCorpMessage、WxCpSchoolContactMessage 等）的 agentId 字段升级为 Long
• 为部分类补充 setAgentId(long)/agentId(long) 以降低使用端对字面量的改动成本
• 更新既有单测以适配 Long，并新增“超长 AgentId”回归测试（WxCpDefaultConfigImplTest）

Technical Notes: 该改动涉及对外公共 API（接口方法签名）变更，可能影响下游编译与序列化/反序列化链路，需要关注兼容性与迁移说明。

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

[augmentcode]

Review completed. 4 suggestions posted.

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

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5c1018e2f3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[devin-ai-integration]

代码审查（事后复审，PR 已合并）

结论：把 agentId 提升为 Long 的方向正确，但改造不完整，并且新增的原始类型重载会在下游产生一个编译期静默、运行期 NPE 的陷阱。建议以补丁 PR 跟进 P1 两项。

P1-1 Solon 插件未同步，未配置 agentId 时启动直接 NPE

• solon-plugins/wx-java-cp-solon-plugin/src/main/java/com/binarywang/solon/wxjava/cp/storage/AbstractWxCpConfigStorageConfiguration.java:18,27
• solon-plugins/wx-java-cp-multi-solon-plugin/src/main/java/com/binarywang/solon/wxjava/cp_multi/configuration/services/AbstractWxCpConfiguration.java:128,137

两处仍是 Integer agentId = properties.getAgentId(); 后直接 config.setAgentId(agentId)。WxCpDefaultConfigImpl 现在同时存在 setAgentId(Long) 与 setAgentId(long)：Integer 实参在重载解析的宽松阶段只能匹配 long（unboxing + widening，Integer → Long 不成立），因此编译期静默选中原始类型重载。实测字节码：

invokevirtual java/lang/Integer.intValue:()I
i2l
invokevirtual setAgentId:(J)V

触发条件：使用通讯录同步 Secret、不配置 agentId（multi 插件自身 Javadoc 就写明「通讯录同步条目：agentId 可不填（null）」）→ 启动时 NullPointerException。改动前 Integer 版本可以正常存 null。

同时，Solon 用户依然无法配置超出 int 范围的 agentId，#4077 在 Solon 侧未修复。

建议：

1. 两个 Solon 插件的 WxCpProperties#agentId、WxCpSingleProperties#agentId 及赋值同步改为 Long；
2. 重新评估 setAgentId(long) / agentId(long) 这类原始类型重载（WxCpDefaultConfigImpl、WxCpMessage、WxCpLinkedCorpMessage、WxCpSchoolContactMessage、BaseBuilder）。它们让下游「传 Integer」的旧代码从「存 null」变成「NPE」，属于无编译告警的行为回归；只保留 Long 重载会强制下游显式修改，风险反而更可控。

P1-2 回调路由仍按 Integer 解析 agentid

weixin-java-cp/src/main/java/me/chanjar/weixin/cp/message/WxCpMessageRouterRule.java:44,76,250

(this.agentId == null || this.agentId.equals(Integer.valueOf(wxMessage.getAgentId())))

规则的 agentId 仍是 Integer，且对回调报文里的 agentid 用 Integer.valueOf(String) 解析。对 1013699173317 这类应用，只要规则上设置了 agentId，路由匹配就会抛 NumberFormatException；即使不设置，也无法为长 agentId 配置按应用路由的规则。这正是本 Issue 的同一类缺陷，建议一并改为 Long.valueOf/Long。

P2-3 其余 agentId 仍为 Integer，第三方/服务商链路会溢出

PR 描述提到「第三方服务商可通过 获取企业授权信息 获取 agentid」，但对应响应 Bean 未改：

• WxCpTpAuthInfo.Agent#agentId:169、WxCpTpPermanentCodeInfo:178、WxCpTpCustomizedAppDetail:123
• WxCpTpService#getAdminList:564、WxCpTpUserService#userId2Openid:153、WxCpUserService#userId2Openid:140、WxCpSchoolUserService#getAllowScope:326、WxCpOaOaScheduleServiceImpl#add:32
• TemplateCardMessage#agentid:27、WxCpCorpGroupCorp#agentid:23、WxCpLivingCreateRequest:46、WxCpMeeting:66、WxCpGroupRobotMessage:66、WxCpMessageSendStatistics:48、WxCpTpContactSearch:43

其中响应 Bean 的影响最直接：Gson 把超过 Integer.MAX_VALUE 的 agentid 解析到 Integer 字段会抛 JsonSyntaxException，长 agentId 企业的授权信息将无法解析。既然本次已经接受了不兼容的类型调整，建议在同一个大版本内一次性收敛，避免下游分两次改。

P2-4 本 PR 夹带了与 agentId 无关的变更

分支中包含 DataUtils 的 openid 脱敏与小程序 getPhoneNumber 改动（与 #4078 重复）。按仓库约定「不要在功能修改中夹带无关改动」，建议后续拆分，便于回溯与回滚。

顺带指出 DataUtils#handleDataWithSecret 去掉了 StringUtils.contains(data, "secret=") 短路，现在所有 String 入参都会跑两次正则；对大 body（如媒体上传的 JSON）是不必要的开销，建议先做 contains 判断。

P3-5 回归测试覆盖偏薄

WxCpDefaultConfigImplTest 只验证了 config 的存取。真正会崩的是「长 agentId 透传到 URL、消息体、Redis key」这几条链路，建议补：

• WxCpMenuServiceImpl#create/get/delete 的 String.format URL 断言；
• WxCpMessage 序列化后 agentid 数值断言；
• Spring Boot 配置绑定 wx.cp.agent-id=1013699173317 的绑定测试。

另外 WxCpAgentServiceImplTest:129 仍是 assertEquals(9, wxCpAgent.getAgentId().intValue())，用 intValue() 断言与本次改动的意图相反，建议改为 longValue()。