企业微信 qiwei callback fix-ready 方案

生成时间：2026-05-17 16:12 +0800 CST · 目标项目：store · 人审状态：待确认

推荐判断

更可能的修复路径是：store 应补最小企业微信 GET URL 验证回调实现，不是直接认定后台配错 URL。

原因是 Apifox/OpenAPI 已存在两个精确接口，参数也符合企业微信 URL 验证形态；告警路径与契约完全一致；但主要部署分支均未实现 Qiwei.php。

分支决策

后台核对结果动作
URL 归属智慧食堂 store，业务需要保留新建任务分支，补 GET URL 验证实现
历史测试、错误应用、错误域名、无人能说明用途删除或改正企业微信后台配置
URL 应指向另一个服务改后台 URL 到正确服务，store 不实现

删除配置核对项

  1. 确认后台入口类型：服务商数据回调、企业应用数据回调、通讯录回调、客户联系回调、消息接收回调或其他。
  2. 确认应用/服务商标识：应用名称、AgentId、SuiteId、CorpId。
  3. 确认当前回调 URL 是否精确为 /api/qiwei/callback 或 /api/qiwei/callbackQW。
  4. 确认 URL 域名是否为 store 域名，而不是其他服务或历史测试域名。
  5. 确认是否有业务 owner 需要接收企业微信事件。

最小实现范围

只实现 GET URL 验证，不处理 POST 事件消息，不新增后台页面，不提交 Token、EncodingAESKey 或 CorpSecret。

建议新增：

路由草案

// 企业微信 URL 验证回调
Route::group('api/qiwei', function() {
    Route::get('/callback', 'api/Qiwei/callback');
    Route::get('/callbackQW', 'api/Qiwei/callbackQW');
});

验收命令

php -l application/api/controller/Qiwei.php
php -l application/api/service/QiweiCallback.php
php -l application/route.php
php tests/manual/qiwei_callback_verify_fixture.php

接口契约同步

风险边界