Webman 中正确使用 EasyWeChat 需手动注入 GuzzleHttp\Client 实例并绑定到容器,避免 PSR-7 自动探测失败;控制器中须用 rawBody 获取 XML 并手动转换响应。

Webman 里直接用 EasyWeChat 是可行的,但不能照搬 Laravel 或传统 PHP 的初始化方式——核心问题是容器注入时机和应用生命周期不匹配,不手动接管实例就容易报 InvalidArgumentException: No PSR-7 implementation found 或 Call to a member function push() on null 这类错误。
为什么 Webman + EasyWeChat 会报 PSR-7 相关错误
EasyWeChat 默认依赖 GuzzleHttp\Psr7 和一个 PSR-7 兼容的 HTTP 工厂(如 nyholm/psr7),但 Webman 默认没自动注册 PSR-7 实现,且其 HttpKernel 不走 Laravel 风格的服务提供者引导流程。EasyWeChat 内部调用 Http::createRequest() 时找不到工厂,就会炸。
- 不是 EasyWeChat 版本问题,v6.x 和 v7.x 都有同样表现
- Webman 的
bootstrap/app.php里直接 new EasyWeChat 会失败,因为底层 HTTP 客户端未初始化 - 必须显式传入已配置好的
HttpClient实例,绕过它自己探测 PSR-7 工厂的逻辑
在 Webman 中正确初始化 EasyWeChat 实例
推荐在 app/Provider/WechatServiceProvider.php 中手动构建并绑定到容器,确保每次获取都是复用同一实例(避免重复鉴权、token 缓存失效)。
微信小程序 TabBar 图标生成技能,使用 Python PIL 绘制简约几何图标(未选中灰、选中绿),自动写入 app.json 配置。适用于“生成 tabBar 图标”、“底部菜单栏图标”、“tab 图标”等指令。
use EasyWeChat\Kernel\ServiceContainer;
use GuzzleHttp\Client;
use Psr\Http\Client\ClientInterface;
return [
'wechat' => function () {
$config = [
'app_id' => 'your-app-id',
'secret' => 'your-app-secret',
'token' => 'your-token',
'aes_key' => 'your-aes-key', // 可选
'response_type' => 'array',
];
$app = new ServiceContainer($config);
// 关键:强制指定 HttpClient,跳过 PSR-7 自动探测
$app->rebind('http_client', new Client([
'timeout' => 5.0,
'verify' => false, // 生产环境请设为 true 或指定 CA 路径
]));
// 可选:替换缓存驱动(默认用 file,Webman 推荐用 redis)
$app->rebind('cache', new \Webman\Redis\Cache());
return $app;
}
];
-
$app->rebind('http_client', ...)是必须步骤,否则后续所有 API 调用(如$app->server->serve())都会失败 - 不要用
EasyWeChat\Factory::officialAccount(),它内部会重新 new ServiceContainer 并尝试自动探测,又回到原问题 - 缓存若用 Redis,请确认
config/cache.php中default已设为redis,且连接正常
在控制器中接收并响应微信服务器请求
Webman 的路由不支持 EasyWeChat 原生的 $app->server->serve() 直接返回响应(它期望 Symfony\Component\HttpFoundation\Response),需手动转换。
use support\Request;
use support\Response;
public function serve(Request $request): Response
{
$app = container()->get('wechat');
$server = $app->server;
// 拦截原始 raw body(微信服务器 POST XML 不带 Content-Type,不能靠 $request->post())
$content = $request->rawBody();
$server->setContent($content);
$server->setRequest($request);
// 执行处理,捕获返回内容(字符串格式 XML)
ob_start();
$server->serve();
$output = ob_get_clean();
// 包装成 Webman 响应,注意 header 和 content-type
return response($output)
->withHeader('Content-Type', 'text/xml; charset=utf-8')
->withStatus(200);
}
- 必须用
$request->rawBody()获取原始 XML,$request->input()或$request->post()在微信推送场景下为空 -
$server->setRequest($request)是为了兼容部分中间件逻辑(比如日志、签名验证),非必需但建议保留 - 不要在
serve()中 throw 异常,EasyWeChat 的异常不会被 Webman 统一捕获,会导致 500 且无日志;应在$server->push()前加 try/catch
最易被忽略的是:微信服务器要求 5 秒内响应,而 Webman 默认的 worker_num 和 task_worker_num 配置偏低时,高并发下可能超时。如果上线后出现“配置未生效”或“消息收不到”,先检查 config/server.php 中 worker_num 是否 ≥4,task_worker_num 是否 ≥2,并确认 redis 缓存连接稳定——token 刷新失败比代码写错更常导致功能静默失效。


















