URLFOR()函数在不同API版本沙箱列表视图按钮中的异常问询

我之前也碰到过这个API版本差异导致的问题，这确实是Salesforce在API 46.0中调整了URLFOR()函数针对Lightning组件跳转的参数传递规则造成的。

核心原因 #

在API 45.0及更早版本中，URLFOR()的第三个参数可以直接传递键值对，这些参数会被自动追加为URL的查询参数，能被实现lightning:isUrlAddressable的组件正常读取。但从API 46.0开始，Salesforce规范了Lightning组件的URL参数传递逻辑：自定义参数必须带有c__前缀，否则不会被解析到组件的pageReference.state中，甚至不会出现在最终的URL里，这就是你看到参数完全丢失的原因。

解决办法 #

你需要修改列表按钮的URL公式，给参数键添加c__前缀，同时调整组件内的参数读取方式：

1. 更新按钮的URL公式
   将原来的公式修改为：

   {!URLFOR("lightning/cmp/c__MyComponent", null, [c__id=Related_Object__c.Id,c__sObjectName="My_SObject_Name__c"])}
   

   或者，你也可以直接构造完整的URL字符串（这种方式在高版本中更稳定）：

   /lightning/cmp/c__MyComponent?c__id={!Related_Object__c.Id}&c__sObjectName=My_SObject_Name__c
   

2. 调整组件内的参数读取逻辑
   在你的c__MyComponent中，通过pageReference.state读取参数时，要加上c__前缀：

   ({
       init: function(component, event, helper) {
           const pageRef = component.get("v.pageReference");
           // 获取带前缀的参数
           const recordId = pageRef.state.c__id;
           const sObjectName = pageRef.state.c__sObjectName;
           console.log('Record ID:', recordId);
           console.log('Object Name:', sObjectName);
       }
   })
   

额外验证点 #

• 确认列表按钮的类型是URL，并且在按钮设置中勾选了“Lightning Experience”支持；
• 确保组件确实正确实现了lightning:isUrlAddressable接口，并且在组件的.cmp文件中声明了pageReference属性：

  <aura:component implements="lightning:isUrlAddressable" access="global">
      <aura:attribute name="pageReference" type="Object"/>
      <!-- 组件其他内容 -->
  </aura:component>
  

这样修改后，在API 46.0的沙箱中就能正常传递并读取参数了。

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