Composer Playground执行交易报错：getAssetRegistry返回null且assetRegistry未定义

我帮你梳理几个最可能的原因和解决办法——这是Hyperledger Composer开发中非常常见的坑，我之前做项目时也踩过好几次：

1. 调用getAssetRegistry时传入的类型完全错误 #

你要明确：getAssetRegistry()需要的是资产类型的完整限定类名（FQCN），而不是交易类型的名字！
看你给出的代码片段，交易类型是org.acme.payrent.Agreement，但如果你调用getAssetRegistry('org.acme.payrent.Agreement')就完全错了——因为这是交易类型，不是资产类型。你需要传入你实际要操作的资产的完整命名空间，比如如果你的资产是org.acme.payrent.Vehicle，那应该写：

const assetRegistry = await getAssetRegistry('org.acme.payrent.Vehicle');

2. 异步函数的async/await没写对 #

getAssetRegistry是异步Promise函数，必须用await来获取返回值，同时你的交易函数必须声明为async，否则代码会跳过异步调用直接执行后面的逻辑，导致assetRegistry还是undefined。
正确的交易函数结构应该是这样的：

/**
 * 车辆下单
 * @param {org.acme.payrent.Agreement} 创建协议交易
 * @transaction
 */
async function createAgreement(tx) {
  // 必须加await，且传入正确的资产类型FQCN
  const assetRegistry = await getAssetRegistry('org.acme.payrent.你的资产类型名');
  
  // 加个判断兜底，避免后续报错
  if (!assetRegistry) {
    throw new Error('无法获取资产注册表，请检查资产类型是否正确');
  }
  
  // 后续的资产操作逻辑，比如添加、更新资产
  // await assetRegistry.add(yourAsset);
}

3. .cto文件中没有定义对应的资产类型 #

如果你的.cto文件里压根没定义你要操作的资产类型，Composer肯定找不到对应的注册表，返回null。确保你的.cto里有类似这样的资产定义：

namespace org.acme.payrent

// 交易类型（你已经定义了）
transaction Agreement {
  --> Participant renter
  --> Vehicle targetVehicle
  DateTime startDate
  DateTime endDate
}

// 必须存在的资产类型
asset Vehicle identified by vehicleId {
  o String vehicleId
  o String brand
  o String model
}

4. 业务网络没有重新部署 #

修改.cto或logic.js后，一定要在Composer Playground里点击「Update Business Network」重新部署，否则Playground运行的还是旧版本的代码，自然找不到新的资产类型或逻辑。

调试小技巧 #

可以在代码里加日志打印，方便排查问题：

const registry = await getAssetRegistry('org.acme.payrent.Vehicle');
console.log('获取到的资产注册表：', registry);
if (!registry) {
  throw new Error('资产注册表获取失败');
}

然后在Playground的「Logs」标签里查看输出，就能知道到底是没找到还是其他问题。

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