Drupal复选框同步Salesforce实现反向传值的异常排查

1. 优先核对传入函数的$communication实际取值 #

你遇到的“不管怎么调整三元判断分支，值都不符合预期”的核心原因，几乎都是这个变量的实际类型和你预设的不一样：

• Drupal webform的复选框字段，默认返回值从来不是原生PHP布尔值，常见返回值包含字符串类型的'0'/'1'、整数类型的0/1、空字符串''、null，如果字段配置成多值结构，还会返回嵌套数组。
• 不要靠主观判断变量值，直接在函数入口加临时日志，把拿到的实际值和类型打出来排查：

function registerAtSalesforce($first_name,$communication){
  // 临时调试日志，排查完记得删除
  \Drupal::logger('salesforce_sync')->notice('同步入参调试：<pre>@val</pre>', [
    '@val' => print_r([
      'first_name' => $first_name,
      'communication' => $communication,
      'communication_type' => gettype($communication)
    ], true)
  ]);
  try{
    // ... 原有业务逻辑
  }
}

• 调整日志输出后，分别在webform勾选、取消勾选两种场景下提交，看两种情况拿到的$communication是不是真的有区分：如果两种场景下拿到的都是非空的truthy值，就会出现你遇到的“调整成正向判断后永远传true”的问题——本质是你传入函数的参数根本没把复选框的勾选状态传对，和判断逻辑无关。

2. 检查Salesforce接口的字段匹配与序列化规则 #

你遇到的“反向判断写好之后Salesforce完全收不到值”的问题，大概率不是判断逻辑错了，而是请求发出去之后Salesforce根本识别不到这个字段：

• 核对字段API名称：Salesforce的自定义字段实际API名是带__c后缀的，如果你写的MarketingCommunicationOptOut实际对应的API名是MarketingCommunicationOptOut__c，或者大小写不匹配，接口入参就算带了值，也会被Salesforce直接忽略，不会存储到对应字段，表现就是“没有接收到任何同步的值”。
• 检查请求的序列化逻辑：PHP的原生布尔值true/false，在部分HTTP客户端配置下，会在JSON编码的时候被转成整数1/0，甚至因为类型不匹配被过滤成空值。你可以在发起请求之前，把最终序列化的Payload打印出来，确认MarketingCommunicationOptOut对应的位置是不是真的带出了非空的布尔值，而不是被提前过滤成了null。

3. 按照反向传值需求调整判断逻辑 #

在确认了变量取值正确、字段名匹配、序列化正常之后，不要依赖松散的三元判断写逻辑，避免因为变量类型不一致踩坑，直接用严格的空值判断做映射：

// 先标准化获取复选框的实际勾选状态
$is_communication_checked = !empty($communication);
// 按照需求做反向映射：未勾选时传true，勾选时传false
$marketing_opt_out = !$is_communication_checked;

$data = [
    'userInput' => [
        'FirstName' => $first_name,
        'MarketingCommunicationOptOut' => $marketing_opt_out,
    ]
];

• 这里用!empty()做判断，刚好适配Drupal复选框的所有常见返回值：不管是返回0、'0'、''、null、字段未传值，都会被判定为未勾选，映射后传true；只要是有效勾选状态的1、'1'，都会被判定为已勾选，映射后传false，不会出现之前的分支判断失效的问题。
• 最后二次校验字段业务逻辑：确认Salesforce端的MarketingCommunicationOptOut字段的定义，避免传值方向和字段业务逻辑相反——就算同步链路完全通了，值的含义和字段预设的逻辑反了，也算业务故障。

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