结论是：用monolog自定义processor脱敏+guzzlepromises异步上报是最可控易维护方案；因monolog内置processor不处理内容过滤，必须在__invoke()中实现白名单/正则匹配脱敏并返回$record，且上报需封装为promise由promise::all()调度，避免同步阻塞。
直接说结论：用 monolog/monolog + 自定义 Processor 做日志脱敏，再配合 guzzlehttp/promises 实现异步上报，是当前 PHP 生态中最可控、最易维护的方案。硬套“日志组件”类库（如 spatie/laravel-logger）反而容易卡在敏感字段识别逻辑和上报时机上。
为什么不能直接用 monolog 的 built-in processors 做脱敏？
Monolog 自带的 IntrospectionProcessor 或 WebProcessor 只负责注入上下文信息，不碰日志内容本身；NormalizerProcessor 会序列化数组但不会过滤字段。真正要脱敏，必须自己写 Processor，且必须在日志写入前介入。
- 脱敏逻辑必须放在
__invoke()方法里，且返回修改后的$record—— 不 return 或 return null 会导致整条日志丢弃 - 常见错误：在 processor 里调用
var_dump()或error_log()，这会干扰异步流程，甚至触发死锁 - 敏感字段名不能写死（比如只处理
password），得支持正则匹配或白名单配置，否则新增字段就得改代码
如何让日志上报不阻塞主线程？
别用 file_put_contents 或同步 curl_exec 写远程 endpoint —— 这等于把日志当 HTTP 请求来发，一卡全卡。正确做法是把上报包装成 Promise，交给 Promise\all() 批量调度。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 上报函数必须返回
Promise实例，不能直接return $response - 别在
then()回调里再抛异常，否则 Promise 链会中断且无日志可查；要用catch()显式捕获并记录失败原因 - 如果上报目标是 Elasticsearch 或 Loki，注意批量接口的 body 大小限制（通常 10–20MB），超限需提前分片，否则
413 Payload Too Large会被静默吞掉
Composer 依赖怎么配才不翻车？
monolog/monolog 和 guzzlehttp/promises 兼容性没问题，但要注意版本组合：
- Monolog v2.x 要求 PHP >= 7.2，v3.x 要求 PHP >= 8.1 —— 如果项目还在用 PHP 7.4，别升 v3
-
guzzlehttp/promisesv2.x 支持 PHP 7.2+，但 v3.x 弃用了wait()，如果你有同步 fallback 场景（比如 CLI 命令强制等上报完成），别升 v3 - 别同时 require
guzzlehttp/guzzle—— 它自带 promises，会造成 autoloader 冲突，报Class GuzzleHttp\Promise\Promise not found
最麻烦的其实是脱敏规则的动态加载——比如不同环境（dev/staging/prod）要启用不同字段掩码策略，又不想重启 PHP-FPM。这时得把规则存在 Redis 或配置中心，而不是写死在 Processor 类里。不然上线后发现手机号没脱敏，只能回滚代码再发版。
