如何正确从Promise向Apex方法传递参数？

核心问题分析 #

传入columnDefinitions参数时Apex方法返回报错，省略该参数则无报错但返回空数组，本质是参数格式/类型与Apex端预期不匹配，或是Apex方法对参数的处理逻辑存在漏洞。

具体排查步骤 #

1. 核对参数结构与Apex类的匹配度 #

如果Apex端用自定义类（比如ColumnDefinition）接收columnDefinitions，JS端传递的参数必须和类的字段完全对应：

• 注意字段名大小写（Apex是驼峰命名，JS要保持一致，不能用下划线）
• 确保必填字段不缺失
• 示例对比：

  // 错误示例：字段名和Apex类不匹配
  const columnDefs = [
    { field_name: 'Id', label: 'ID' }
  ];
  // 正确示例：和Apex类字段名完全对齐
  const columnDefs = [
    { fieldName: 'Id', label: 'ID' }
  ];
  

  Apex端自定义类参考：

  public class ColumnDefinition {
      @AuraEnabled
      public String fieldName;
      @AuraEnabled
      public String label;
      // 其他字段也要加@AuraEnabled才能被JS识别
  }
  

2. 检查Apex方法的参数处理逻辑 #

确认Apex方法的参数修饰符和非空校验是否到位：

@AuraEnabled(cacheable=true)
public static List<sObject> fetchData(List<ColumnDefinition> columnDefinitions) {
    // 先做非空判断，避免空指针报错
    if(columnDefinitions == null || columnDefinitions.isEmpty()) {
        return new List<sObject>();
    }
    // 后续业务逻辑
}

如果方法里直接对columnDefinitions做循环或字段访问，没加非空判断，极大概率会抛出空指针异常。

3. 从报错信息定位具体问题 #

从你提供的报错截图里提取关键信息：

• 若报错是System.NullPointerException：优先检查Apex端是否有未校验空值的代码
• 若报错是System.JSONException：说明JS传递的JSON格式不符合要求，比如字段类型不匹配（Apex要Integer，JS传了字符串）

4. 调试参数传递内容 #

在JS端打印实际发送的参数，确认JSON结构：

const columnDefs = [/* 你的列定义 */];
console.log('实际传递参数:', JSON.stringify(columnDefs));
// 调用Apex方法
fetchData({columnDefinitions: columnDefs})
  .then(result => console.log(result))
  .catch(error => console.error('报错详情:', error));

把打印出的JSON和Apex类的字段做逐一比对，找格式差异。

快速验证方案 #

先构造极简参数测试，缩小问题范围：

// 只传最基础的必填字段
const testDefs = [{ fieldName: 'Name', label: '名称' }];
fetchData({columnDefinitions: testDefs})
  .then(res => console.log(res))
  .catch(err => console.log(err));

如果这个测试能成功，说明之前的参数里存在个别字段格式错误；如果仍报错，直接排查Apex方法的逻辑漏洞。

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