fabric List返回类型引起的异常：org.hyperledger.fabric.Logger error java.lang.NullPointerException

问题

定义了获取所有用户的方法，返回类型为List，User类型有@DataType标注。

    @Transaction(intent = Transaction.TYPE.EVALUATE)
    public List<User> getAllUsers(Context ctx, String startKey) {
        List<User> users = new LinkedList<>();
        startKey = Optional.ofNullable(startKey).orElse(ChaincodeConstants.USER_KEY_PREFIX);
        QueryResultsIterator<KeyValue> values = ctx.getStub().getStateByRange(startKey, "");
        values.forEach(keyValue -> {
            String value = new String(keyValue.getValue(), StandardCharsets.UTF_8);
            logger.info(String.format("userId=%s,value=%s,stringValue=%s", keyValue.getKey(), value, keyValue.getStringValue()));
            User user = convert2User(value);
            users.add(user);
        });
        return users;
    }

这是很正常的Java方法，返回类型为List，但是运行之后出现了异常：

Thread[fabric-txinvoke:2,5,main] 17:41:38:218 SEVERE  org.hyperledger.fabric.Logger error                                              nulljava.lang.NullPointerException
	at org.hyperledger.fabric.contract.execution.JSONTransactionSerializer.toBuffer(JSONTransactionSerializer.java:84)
	at org.hyperledger.fabric.contract.execution.impl.ContractExecutionService.convertReturn(ContractExecutionService.java:89)
	at org.hyperledger.fabric.contract.execution.impl.ContractExecutionService.executeRequest(ContractExecutionService.java:66)
	at org.hyperledger.fabric.contract.ContractRouter.processRequest(ContractRouter.java:116)
	at org.hyperledger.fabric.contract.ContractRouter.invoke(ContractRouter.java:127)
	at org.hyperledger.fabric.shim.impl.ChaincodeInvocationTask.call(ChaincodeInvocationTask.java:106)
	at org.hyperledger.fabric.shim.impl.InvocationTaskManager.lambda$newTask$17(InvocationTaskManager.java:265)
	at java.base/java.util.concurrent.CompletableFuture$AsyncRun.run(CompletableFuture.java:1736)
	at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
	at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
	at java.base/java.lang.Thread.run(Thread.java:829)

解决办法

把方法类型List<User> 修改为User[]。代码如下：

    @Transaction(intent = Transaction.TYPE.EVALUATE)
    public User[] getAllUsers(Context ctx, String startKey) {
        List<User> users = new LinkedList<>();
        startKey = Optional.ofNullable(startKey).orElse(ChaincodeConstants.USER_KEY_PREFIX);
        QueryResultsIterator<KeyValue> values = ctx.getStub().getStateByRange(startKey, "");
        values.forEach(keyValue -> {
            logger.info(String.format("userId=%s,stringValue=%s", keyValue.getKey(), keyValue.getStringValue()));
            User user = convert2User(keyValue.getStringValue());
            users.add(user);
        });
        return users.toArray(new User[0]);
    }

原因解释

首先介绍一下背景； Java、Go 和 Typescript 中可用的 ContractAPI 用于生成整个合约的“模型”，包括从交易函数传递和返回的数据类型。 （JavaScript 根据其类型尽可能支持有限的子集）。

为了支持这一点，必须有某种“序列化器”来处理数据。 ‘invoke(byte[]): byte[]’ 的底层链码 API 为开发人员提供了按照他们希望的方式序列化的能力，尽管并非所有人都需要使用该能力。

ContractAPI 中有一个默认的“序列化器”；如果需要的话可以更换。Java默认序列化是org.hyperledger.fabric.contract.execution.JSONTransactionSerializer。

fabric返回类型可以是：

• strings, 字符串，
• numbers (for Java this is any of the primitive ‘number’ types) 数字（对于 Java，这是任何原始的“数字”类型）
• booleans, 布尔值，
• other types that have been annotated.已注解（@DataType）的其他类型。
• arrays of the above 上面类型的数组，例如 String[]、Integer[]、User[].