Project Reactor中log()调用位置为何不影响日志输出？

这里的“观察”是指log()作为无侵入式的透传调试节点，会把流经自身所在链路位置的所有符合Reactive Streams规范的标准化交互信号全部记录下来，整个过程不会修改信号携带的数据、不会拦截信号的流转、也不会改变链路的业务行为。
它能实际观测到的信号具体包含以下几类：

• onSubscribe：下游发起订阅时，传递给上游的Subscription订阅凭证
• onNext：每一个流经该节点的业务数据值
• onError：链路发生异常时，向下游传递的终止异常对象
• onComplete：链路无异常走完所有流程时，向下游传递的正常终止通知
• cancel：下游主动断开订阅时，向上游传递的取消指令
• request：下游根据自身处理能力，向上游发起的拉取数据的请求量

需要明确的是，log()的观测范围是严格和自身的链路位置绑定的，它只能感知到流经自己节点的信号，对上游、下游其他节点处理过的内容完全无感知。

首先要澄清一个容易忽略的细节：从严格的日志内容细节来说，两个位置的log输出并非完全没有差异：

• 位于map之前的log()，会在onNext阶段打印原始的小写字符串vashishth
• 位于map之后的log()，会在onNext阶段打印转大写后的字符串VASHISHTH

你感知到的“输出结果完全一致”，本质是两种场景下日志的结构骨架完全对齐：

1. 不管把log()放在链路的哪个位置，它的工作逻辑是完全固定的：收到上游的任何信号时，先按固定格式打印日志，再把信号原封不动转发给下游；收到下游发来的请求、取消指令时，也是先打印日志，再原封不动转发给上游。它本身不做任何数据转换、不做任何拦截，和位置无关的运行逻辑决定了它输出的日志格式、信号流转顺序是完全统一的。
2. 示例代码里的map是同步无异步切换的操作，整个链路都在同一个订阅线程里执行，log()打印出来的线程名、信号的触发时序完全没有差异，很容易让人忽略掉仅存在于数据值层面的细微区别，从而产生“位置不影响输出”的错觉。

容易混淆的认知点 #

很多人会把log()当成全链路的全局调试埋点，实际上它的观测边界完全由在链路里的位置决定：

• 如果链路里包含线程切换操作，不同位置的log()打印出来的线程名差异会非常直观，根本不会觉得位置不影响结果
• 如果map节点执行时抛出异常，放在map前面的log()永远不会捕获到这个异常——因为异常是从抛出点顺着链路向下游传递，只有经过抛出点之后的log()节点，才能观测到这个onError信号

内容的提问来源于stack exchange，提问作者vashishth