Webman不适合直接渲染资产负债表或执行复杂报表计算，因其多表关联、余额推算、科目树递归等操作会阻塞协程，导致Worker进程锁死、RPS骤降、其他服务卡顿；正确做法是将报表生成剥离为异步队列+专用计算服务，Webman仅作为实时数据网关和原子接口提供者。
Webman 不适合直接渲染资产负债表页面或执行复杂报表计算，它只该负责实时数据采集、原子接口暴露和任务触发——真正的报表生成必须交给异步队列 + 专用计算服务。
为什么不能在 Webman 中直接做资产负债表渲染
资产负债表涉及多表关联、期初/期末余额推算、科目树递归展开、单位换算（万元/元）、跨期间对比等逻辑，这些操作天然阻塞协程。一旦在 app\controller\ReportController 里调用 calculateBalanceSheet() 并同步查库+计算，整个 worker 进程会被锁死，RPS 瞬间跌穿 200，其他订单同步、设备上报全部卡住。
常见错误现象：Class 'app\controller\UserController' not found 往往是开发者强行把 ThinkPHP 风格的“控制器+视图”搬进 Webman，却忽略了它根本没内置模板引擎和视图编译器。
- Webman 的
view目录仅用于简单 HTML 返回，不支持 Blade、Twig 或任何模板继承语法 - 所有财务计算逻辑必须剥离到独立 CLI 命令或异步任务中运行
- 前端报表页面应由 Vue Admin 或 Laravel Nova 渲染，Webman 只提供
/api/v1/balance-sheet/{period}这类纯 JSON 接口
如何用 Webman 接收并转发资产负债数据
Webman 最合理的角色是「实时数据网关」：接收 IoT 设备、ERP 子系统、银行对账文件的原始凭证流，校验后投递到消息队列，不参与任何计算。
实操建议：
- 在
app\controller\AccountingController.php中定义storeVoucher()方法，只做字段校验（如amount是否为数字、account_code是否在科目表中存在） - 校验通过后，用
redis->lpush('voucher_queue', $json)投递到 Redis 队列，而非直接写 DB - 禁用
file_put_contents()记日志，改用Monolog\Handler\StreamHandler+BufferHandler，避免 I/O 阻塞协程 - 不要在路由闭包里写业务逻辑，所有入口必须走控制器方法，否则热更新时
php start.php rload无法重载
定时生成报表必须隔离进程
资产负债表按月/季/年生成，属于典型耗时任务。若塞进默认 task 进程，会阻塞所有其他定时任务（如库存日结、设备心跳检测）。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
正确做法是在 config/process.php 中单独声明一个报表进程：
return [
'balance-sheet-generator' => [
'handler' => app\process\BalanceSheetGenerator::class,
'reloadable' => false, // 关键！防止热更新时重复触发
],
];并在 app/process/BalanceSheetGenerator.php 中启动独立 Crontab：
public function onWorkerStart()
{
new Crontab('0 0 1 * *', function () { // 每月1号0点
$command = 'php artisan balance-sheet:generate --period=last-month';
exec($command . ' > /dev/null 2>&1 &');
});
}-
reloadable => false是部署时最容易被忽略的细节，否则php start.php reload会导致日结任务跑两次 - 用
exec()启动独立 PHP 进程，而非直接调用函数，彻底隔离内存与协程上下文 - 报表计算过程使用
phpspreadsheet+redis queue异步生成 Excel，Webman 只负责返回{status: "pending", task_id: "bs-202606"}
前端如何安全获取报表数据
Webman 提供的不是 HTML 页面，而是状态可轮询的原子 API。前端需分三步调用：
- 第一步 POST
/api/v1/balance-sheet/generate提交生成请求，拿到task_id - 第二步轮询 GET
/api/v1/task/{task_id}，直到返回"status": "done" - 第三步 GET
/api/v1/balance-sheet/download?task_id={id}下载 Excel 文件（该接口应由 Nginx 直接代理静态文件，不经过 PHP）
注意：所有接口必须强制校验 JWT token，并在中间件中拦截非授权租户的 tenant_id 参数——Webman 不处理 RBAC 渲染，但必须做路由级权限拦截。
真正复杂的不是接口怎么写，而是谁来算、在哪算、什么时候算。Webman 的价值不在报表本身，而在让报表生成这件事变得可调度、可监控、不拖垮主服务。
