Hyperledger Fabric 2.5 联盟链开发：智能合约（Chaincode）编写与测试指南

一、Chaincode 核心概念

1. 作用：
   智能合约是联盟链的业务逻辑载体，负责账本状态读写（如资产转移、数据验证），在Fabric中通过Invoke()和Init()接口实现。

2. 开发语言：
   支持 Go/Node.js/Java，推荐使用 Go（官方维护最完善）。关键依赖：

   import (
       "github.com/hyperledger/fabric-contract-api-go/contractapi"
       "github.com/hyperledger/fabric-protos-go/peer"
   )
   

二、Chaincode 编写步骤

1. 基本结构

type SmartContract struct {
    contractapi.Contract
}

func (s *SmartContract) Init(ctx contractapi.TransactionContextInterface) peer.Response {
    // 初始化账本状态
    return shim.Success(nil)
}

func (s *SmartContract) Invoke(ctx contractapi.TransactionContextInterface) peer.Response {
    // 路由业务函数
    fn, args := ctx.GetStub().GetFunctionAndParameters()
    switch fn {
    case "TransferAsset":
        return s.TransferAsset(ctx, args)
    default:
        return shim.Error("无效操作")
    }
}

2. 关键业务实现（示例：资产转移）

func (s *SmartContract) TransferAsset(
    ctx contractapi.TransactionContextInterface, 
    args []string,
) peer.Response {
    // 参数校验
    if len(args) != 3 {
        return shim.Error("参数格式: [资产ID, 新所有者, 转移金额]")
    }

    // 读取当前资产状态
    assetJSON, err := ctx.GetStub().GetState(args[0])
    if err != nil || assetJSON == nil {
        return shim.Error("资产不存在")
    }

    // 解析并更新数据
    var asset Asset
    json.Unmarshal(assetJSON, &asset)
    asset.Owner = args[1]
    asset.Balance -= args[2]  // 简化处理，实际需校验数值

    // 写回账本
    updatedAsset, _ := json.Marshal(asset)
    ctx.GetStub().PutState(args[0], updatedAsset)
    return shim.Success([]byte("转移成功"))
}

三、测试方法论

1. 单元测试（使用MockStub）

func TestTransferAsset(t *testing.T) {
    // 初始化模拟环境
    chaincode := new(SmartContract)
    stub := shim.NewMockStub("test", chaincode)

    // 预设测试数据
    stub.MockInit("init", [][]byte{})
    stub.MockPutState("asset1", []byte(`{"id":"asset1","owner":"A","balance":100}`))

    // 执行调用
    resp := stub.MockInvoke("transfer", [][]byte{
        []byte("TransferAsset"),
        []byte("asset1"), []byte("B"), []byte("20"),
    })

    // 验证结果
    if resp.Status != shim.OK {
        t.Errorf("调用失败: %s", resp.Message)
    }
    
    // 检查账本状态
    updated, _ := stub.GetState("asset1")
    assert.Contains(t, string(updated), `"owner":"B"`)  // 使用测试断言库
}

2. 网络测试（使用Fabric测试网络）

# 启动测试网络
cd fabric-samples/test-network
./network.sh up createChannel -c mychannel

# 部署Chaincode
./network.sh deployCC -ccn mycontract -ccp ../chaincode/go/ -ccl go

四、最佳实践与调试

1. 状态管理：

   • 使用复合键存储关联数据：CreateCompositeKey()
   • 批量写入提升性能：DelState() + PutState() 组合

2. 错误处理：

   • 关键原则：所有错误必须显式返回，避免panic
   • 使用标准错误码：

     return shim.Error("404: 资产不存在")
     

3. 性能优化：

   • 避免在链码内执行复杂计算（如加密运算）
   • 使用分页查询：GetStateByRangeWithPagination()

五、常见问题解决

调试提示：通过chaincode-logs查看实时日志：

docker logs dev-peer0.org1.example.com-mycontract-1.0 2>&1 | grep "业务关键字"

通过以上步骤，可系统化完成Chaincode开发与验证。实际部署前建议使用Fabric CA测试权限策略。