Fabric Node.js链码方法可选参数设置失败问题咨询

问题根因 #

fabric-contract-api 默认开启方法参数数量强校验：部署链码时会扫描合约类所有公开方法的形参列表，统计排除第一个上下文参数ctx之外的形参数量，调用时传入的业务参数个数必须和统计值完全匹配。该校验逻辑不会识别JS原生的默认参数、可选参数语法，因此你尝试的两种写法都会触发参数个数校验失败。

可用解决方案 #

方案1：使用剩余参数适配可选参数

将可选参数用剩余参数语法接收，即可兼容不同数量的参数传入，同时保留必填参数的显性定义：

async getAllMarks(ctx, studentId, ...optionalArgs) {
    // 可选参数不存在时默认赋值为null
    const subject = optionalArgs[0] ?? null;
    // 后续业务逻辑
}

该方案下API统计的必填业务参数仅为1个（studentId），调用时传1个或2个业务参数都可以通过校验。

方案2：手动从上下文提取参数（完全自定义解析逻辑）

不依赖框架的自动参数注入，直接从交易上下文的stub对象中拉取所有参数，完全自己控制校验逻辑，适合可选参数多、参数结构复杂的场景：

async getAllMarks(ctx) {
    // getArgs返回的数组第一个元素是调用的方法名，后续元素为传入的参数，默认是Buffer类型
    const args = ctx.stub.getArgs().map(buf => buf.toString('utf8'));
    const studentId = args[1];
    if (!studentId) {
        throw new Error('缺少必填参数studentId');
    }
    const subject = args[2] ?? null;
    // 后续业务逻辑
}

方案3：单JSON参数传参（推荐复杂参数场景使用）

调用时将所有业务参数打包为JSON字符串作为单个参数传入，方法内反序列化后即可直接使用可选参数语法：

// 方法定义
async getAllMarks(ctx, paramsJson) {
    const { studentId, subject = null } = JSON.parse(paramsJson);
    // 后续业务逻辑
}

// 仅传必填参数的调用示例
// 传入参数: JSON.stringify({studentId: "2024001"})
// 携带可选参数的调用示例
// 传入参数: JSON.stringify({studentId: "2024001", subject: "math"})

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