Aerospike Java客户端put写入时报Error Code 4参数错误

问题场景 #

通过如下方法向Aerospike写入boolean类型数据：

public void putIsMentionedInMsg(String key, boolean isMentioned) {
    try {
        if (isActive() ) {
            final WritePolicy TOKEN_WRITE_POLICY = new WritePolicy();
            TOKEN_WRITE_POLICY.expiration = (int) Settings.MENTIONED_IN_MESSAGE_EXPIRE_DURATION / 1000;
            TOKEN_WRITE_POLICY.recordExistsAction = RecordExistsAction.REPLACE;
            TOKEN_WRITE_POLICY.commitLevel = CommitLevel.COMMIT_MASTER;
            getClient().put(
                    TOKEN_WRITE_POLICY,
                    getKey(ChatSettings.MENTIONED_IN_MESSAGE_SET_NAME, Value.get(key)),
                    new Bin("key", key)
                    new Bin("value", isMentioned)
            );
        }
    } catch (Throwable e) {
        logger.warn("An exception occurred", e);
    }
}

依赖的getKey方法实现：

Key getKey(String setName, Value value) {
    return new Key(Settings.AEROSPIKE_NAMESPACE, setName, value);
}

运行时抛出异常：

com.aerospike.client.AerospikeException: Error Code 4: Parameter error
    at com.aerospike.client.command.WriteCommand.parseResult(WriteCommand.java:54)
    at com.aerospike.client.command.SyncCommand.execute(SyncCommand.java:82)

已确认传入的isMentioned为原生boolean类型，取值仅为true/false、无null值，排除REPLACE策略下空值触发报错的可能。

根因定位 #

触发参数错误的核心原因按优先级排查如下：

• 类型不兼容：Aerospike仅在5.6及以上服务端版本、搭配5.1.0及以上Java客户端时才原生支持boolean类型，低版本环境下直接将原生boolean值传入Bin构造器，客户端无法识别对应的值类型，会直接判定为非法参数抛出Error Code 4，这是该场景下最常见的触发原因。
• 语法错误：getClient().put()方法传入的两个Bin参数之间缺少逗号分隔，该问题会直接导致编译失败，如果是线上运行时抛出异常，大概率是贴代码时遗漏了逗号，可先核对实际运行代码的语法正确性。
• 配置非法：如果Settings.AEROSPIKE_NAMESPACE配置的命名空间不是服务端提前创建的，或是命名空间、set名称包含超长字符、非法特殊字符，也会返回参数错误。

修复方案 #

• 补全Bin参数之间缺失的逗号，保证代码语法正确
• 布尔值做类型转换后再写入，两种常用实现：
  • 整数存储（性能最优）：new Bin("value", isMentioned ? 1 : 0)，读取数据时判断整数值为1则为true，0则为false
  • 字符串存储：new Bin("value", String.valueOf(isMentioned))，读取时通过Boolean.parseBoolean()还原布尔值
• 核对namespace、set相关配置，保证和服务端配置一致，无非法字符。如果确认服务端和客户端版本满足boolean原生支持要求，可跳过类型转换步骤。

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