区块链技术学习站
实践 · 综合项目

项目实例:区块链 × 物联网

一个冷链温控可信溯源与自动理赔平台的完整设计:架构、数据模型、合约、资料清单与未来改进空间,以及它真正解决的生产问题。

场景:一箱疫苗的 1800 公里

一批需要全程 2~8℃ 冷藏的生物制品,从苏州的生产企业发出,送到成都的收货单位。全程 1800 公里、约 42 小时,被切成三段:

① 干线运输

生产企业 → 承运商 A 的冷藏车 → 武汉中转冷库。

② 中转暂存

冷库卸货、入库、出库,涉及一次责任交接与一次温度环境切换。

③ 区域配送

承运商 B 的冷藏车 → 成都收货单位,末端还有多次开门卸货。

参与方一共七个:生产企业、承运商 A、中转冷库、承运商 B、收货单位、保险公司、行业监管。每一方都有自己的系统,每一方都只相信自己系统里的数据——这就是问题开始的地方。

说明 本页是一个可直接照着做的项目设计(架构、数据模型、合约接口、资料清单、路线图),不是某个已上线产品的宣传材料。文中所有量化数字均为设计目标或行业常见量级,用于估算与方案论证,落地时需用真实业务数据重新测算。

它到底解决了什么生产问题

先说清楚"为什么必须用区块链",否则就是一个普通的物联网监控项目。

生产痛点改造前的做法区块链 + IoT 之后产生的价值
温控数据不可信 随车记录仪可事后补录,纸质温度记录可以"照着标准值"补写;最常见的造假是到货前把探头放进保温杯。 温度值在设备端由安全芯片签名后才发出,平台与司机都无法代签;缺签名的样本一律标记为不可采信。 把"信不信这份数据"变成"验一下签名",争议从扯皮变成技术判定。
责任界定困难 三段运输各记各的,超温后互相甩锅,最后靠保险公司派人现场取证。 每一段起止都有双签交接事件(双方签名 + 时间 + GPS + 铅封号),超温时刻可精确落在某一责任段的某一分钟。 责任判定从"协商 30 天"变成"查链 3 分钟"。
异常发现严重滞后 货到目的地才导数据,超温往往已持续十几小时,整车报废。 边缘网关实时跑规则,超温即刻触发链上事件 + 短信/电话通知,途中可补冷、可就近进冷库。 从"事后报废"变为"途中挽救",直接减少货损。
理赔与结算周期长 人工收集各方记录、比对、定责、核算,30~60 天是常态。 理赔规则写进合约并版本化,触发条件满足即自动计算责任方与赔付比例,证据包自动生成。 结算周期压缩到天级,同时减少错赔与通融赔付。
监管取证与审计难 监管方做一次检查要向多家企业分别调数据,格式不一、时间对不上。 监管方作为只读节点接入,直接同步链上数据;证据链自带时间戳与签名,不可抵赖。 检查成本大幅下降,企业也从"反复迎检"中解放出来。
多方数据不互认 每家一套系统,对账靠人工导 Excel,口径不一致。 统一数据模型与合约接口,各方基于同一份账本对账,链下系统各自保留。 不推翻现有系统,只增加一层"共同认可的真相"。
判断标准 如果场景里只有一个参与方,用数据库 + 审计日志就够了,上链是过度设计。只有当存在多方互不信任、需要共同记录、且事后可能争议时,区块链才有不可替代的价值——冷链、跨境、多方联合溯源正是这类场景。

总体架构:五层与它们的职责

区块链 + 物联网冷链平台的五层架构 感知层 温控终端(SE 芯片签名) GPS / 门磁 / 冷机 冷库固定测点 司机 App 边缘层 车载 / 冷库边缘网关(工业级) 采集聚合 · 本地规则告警 · 断网续传缓存 · 批量 Merkle 打包 · 设备身份代理 平台层 EMQX MQTT Broker 百万长连接接入 TDengine 时序库 原始明细存储 MinIO 对象存储 证据包 / 报告 / 视频 区块链层 联盟链 · 设备注册 / 运单批次 / 温控存证 / 双签交接 / 理赔合约 · 监管只读节点
层关键组件这一层必须做到的事
感知层温控终端、安全芯片(SE/TPM)、GPS、门磁、冷机控制器私钥出厂注入安全芯片且永不出芯片;每条样本带设备签名与单调计数器(防重放);上报校准证书编号与有效期。
边缘层工业网关(ARM,宽温,4G/5G + 有线)弱网与断网下不丢数据(本地持久化队列);按窗口聚合+Merkle 打包;本地规则秒级告警;作为设备向链发交易的代理(设备不直接连链)。
平台层EMQX、TDengine、MinIO、规则引擎、索引服务承接高吞吐明细数据;把链上事件回写索引,供应用查询;只把锚定交易发往链,不把明细灌进链。
区块链层联盟链(4~7 共识节点)+ 监管只读节点 + 合约集提供跨机构的共同账本与自动执行;合约版本化;节点分布在不同参与方机房;监管节点只同步不参与共识。
应用层API 网关、Web 看板、扫码验真页、对账结算、监管视图面向不同角色提供不同视图;对外只暴露"验证"能力,不暴露其他客户的业务数据。

一次运输的完整流程

  1. 建单与绑定生产企业在平台创建运单(批次号、温区、允许偏差、参与方清单),调用运单合约写入链;装车时扫描设备序列号,生成设备—运单绑定交易。
  2. 在途采集终端每 60 秒采样一次温度/湿度,签名后发往边缘网关;网关聚合为 15 分钟窗口,计算 min/max/avg 与超限次数。
  3. 批量锚定每小时(或每 20 个窗口)把该时段所有原始样本构造成 Merkle 树,仅把根哈希 + 统计摘要 + 设备签名提交到存证合约。
  4. 异常告警网关本地判定超温即上链 ExcursionDetected 事件并通知责任人;应用侧触发处置工单(补冷 / 就近入库 / 改派)。
  5. 中转交接卸货方与接货方各自用 App 签名确认(时间、GPS、铅封号、外观照片哈希),两笔签名齐全才生成 HandoverConfirmed。
  6. 到货结案生成全程报告(PDF)+ 所有窗口的 Merkle 根清单,报告哈希上链;运单状态置为 CLOSED。
  7. 自动理赔若途中出现定责事件,理赔合约按规则版本读取链上交接与超温记录,计算责任段与赔付比例,生成 ClaimSettled,各方对账。

链上数据模型与合约设计

设计原则:链上存"可判定的事实与承诺",链下存"可分析的明细"。下面是一套可直接落地的结构(字段名保持 snake 风格便于与链下对齐)。

结构主要字段上链方式
Device 设备device_id、pub_key、cert_hash、vendor、model、calib_expire、status写入(注册/吊销)
Shipment 运单shipment_id、batch_no、product_code、temp_min/max、allow_excursion_min、parties[]、status写入
Binding 绑定shipment_id、device_id、bind_ts、unbind_ts、sig写入
TempAnchor 温控锚定anchor_id、shipment_id、period_start/end、sample_count、t_min/t_max/t_avg、excursion_count、merkle_root、raw_uri、device_sig写入(高频)
Handover 交接shipment_id、from_party、to_party、gps、seal_no、photo_hash、ts、sig_from、sig_to写入(双签)
Incident 异常shipment_id、type、start_ts、duration_s、max_deviation、evidence_ref、handled写入
Claim 理赔claim_id、shipment_id、liable_party、amount、rule_version、state写入 + 状态机

合约划分:建议拆成四个合约而不是一个巨石合约,便于升级与权限隔离。

合约主要接口权限
DeviceRegistryregister() revoke() rotateKey() isActive()厂商 + 联盟管理员
Shipmentcreate() bindDevice() confirmHandover(from,to,…) close()参与方各自签名
TempOracle(存证)submitAnchor(anchor) getAnchors(shipmentId) verifySample(root, leaf, proof)边缘网关(白名单)+ 设备签名校验
ClaimRule / ClaimsetRule(version, params) evaluate(shipmentId) settle() appeal()规则由联盟治理投票;结算自动

对外发出的事件(供链下索引服务消费):AnchorSubmitted、ExcursionDetected、HandoverConfirmed、IncidentHandled、ClaimSettled。事件只放 ID 与关键字段,详细内容查链下。

上链策略:什么上链,什么坚决不上链

数据是否上链理由
每一条温度采样值(秒级/分钟级)不上链量大、无独立判定价值;存时序库,用 Merkle 根整体锚定即可。
15 分钟窗口的统计 + Merkle 根上链既能判定是否超标,又能用根哈希验证任意一条原始样本未被改。
设备签名与公钥指纹上链证明数据来源,是整套信任的锚点。
交接双签记录上链责任切分的关键事实,争议时唯一依据。
客户名称、药品价格、合同金额不上链商业隐私;链上只放哈希,明文留在各自系统内。
司机姓名、电话等个人信息不上链个人信息保护要求;如必须关联,用假名 ID + 链下授权解密。
视频、照片、PDF 报告不上链存对象存储,哈希上链,链上存 URI(注意 URI 可用性与防篡改)。
批量锚定带来的量级变化 假设 42 小时运输、每 60 秒一条样本,共约 2520 条;若逐条上链需 2520 次写。改为"15 分钟聚合 + 每小时锚定"后,约 42 次上链写。写入次数下降约两个数量级,而任意一条原始样本仍可通过 Merkle 证明被验证。这是 IoT 上链最实用的一条工程经验。

技术选型与资料清单

层组件用途与选型理由资料
设备STM32 + SHT3x 温湿度 + BC26/N58 NB-IoT;ATECC608A 或 OPTIGA 安全芯片低成本、低功耗;签名在芯片内完成,私钥不可导出,从物理上解决"平台代签"。Microchip ATECC608A 数据手册与 cryptoauthlib
设备GPS/北斗模块、门磁开关、铅封(带 RFID/二维码)提供位置与"是否被打开"的佐证,与温度联合判责。国标铅封与 RFID 相关规范
边缘ARM 工业网关(Debian + Docker)、本地 SQLite/LevelDB 队列断网续传、本地规则、打包;比"终端直连链"可靠得多。EMQX Neuron / eKuiper 边缘流处理文档
接入EMQX(MQTT Broker)单机可支撑十万级连接;支持 TLS 双向认证与主题级 ACL。emqx.io 文档
存储TDengine / InfluxDB(时序)、MinIO(对象)、PostgreSQL(业务)时序库压缩比高、按时间窗口查询快,适合温度明细。tdengine.com 文档
链FISCO BCOS 或长安链 ChainMaker(国产联盟链)无 Gas 成本、权限体系完善、国密支持、有配套中间件与控制台,适配国内合规要求。fisco-bcos.org、chainmaker.org.cn 官方文档
链中间件WeBASE(FISCO 配套)或长安链 cmc / 链下索引服务合约管理、私钥托管、事件订阅、交易上链封装,省掉大量重复开发。webasedoc.readthedocs.io
应用FastAPI / Spring Boot、Vue3、GrafanaAPI 与看板;Grafana 直接读时序库画温度曲线与告警带。grafana.com 文档
标准GS1 EPCIS 2.0、GB/T 冷链物流相关规范、GSP、IEEE 2418.2事件模型与编码对齐国标/国际标准,避免每接一个伙伴改一次接口。gs1.org、ieee.org 标准文本
选型提醒 联盟链选型先看三点:参与方能否各自部署节点(否则等于找个中心化的托管)、是否有国密与等保支撑(国内行业项目常见硬性要求)、运维成本。不要把"TPS 高"当第一指标——本方案真实上链频率不到每秒 1 笔。

部署拓扑与代码结构

最小可用部署:链 4 节点(分布在生产、承运 A、冷库、监管四方机房)+ 1 个监管只读节点;平台侧单机 Docker Compose 起步,后期再拆。

# docker-compose.yml(平台侧精简版)
services:
  emqx:
    image: emqx/emqx:5.7
    ports: ["1883:1883", "8883:8883", "18083:18083"]
  tdengine:
    image: tdengine/tdengine:3.3.0.0
    volumes: ["td-data:/var/lib/taos"]
  minio:
    image: minio/minio
    command: server /data --console-address ":9001"
  indexer:                       # 订阅链上事件 → 写业务库,供 API 查询
    build: ./services/indexer
    environment:
      CHAIN_RPC: "http://chain-node1:8545"
  api:
    build: ./services/api
    ports: ["8000:8000"]
  web:
    build: ./web
    ports: ["8080:80"]
coldchain-bcp/                     # 项目目录建议结构
├── contracts/                    # 合约(Solidity / ChainMaker 的 Rust/Go 合约)
│   ├── DeviceRegistry.sol
│   ├── Shipment.sol
│   ├── TempOracle.sol
│   ├── Claim.sol
│   └── test/                     # 合约单测:权限、双签、边界温度
├── device/                       # 终端固件(C)+ 安全芯片驱动
├── edge/                         # 边缘网关(Python/Go)
│   ├── collector.py              # MQTT 订阅 + 验签 + 落本地队列
│   ├── window.py                 # 15 分钟聚合统计
│   ├── merkle.py                 # Merkle 树构造与证明
│   └── anchor.py                 # 调合约 submitAnchor,失败重试
├── services/
│   ├── indexer/                  # 链上事件 → 业务库
│   ├── api/                      # REST:运单、看板、验证
│   └── notifier/                 # 告警通知(短信/电话/企微)
├── web/                          # 看板 + 扫码验真页
└── deploy/                       # ansible / compose / 监控告警规则

四段关键代码

① 设备端:签名后再上报

# 终端侧伪码:真实实现在 MCU 内调用安全芯片
payload = {
  "device_id": DEVICE_ID,
  "ts": rtc_time(),          # 需做时钟漂移校正,或用网关时间兜底
  "temp": 4.62, "rh": 58.1,
  "lat": 31.31, "lng": 120.62,
  "seq": monotonic_counter(), # 单调计数,防重放与补录
  "calib": CALIB_CERT_NO,
}
canon = json.dumps(payload, sort_keys=True, separators=(",", ":"))
payload["sig"] = se_sign(sha256(canon))      # 私钥不出芯片
mqtt.publish(f"cc/{DEVICE_ID}/sample", json.dumps(payload), qos=1)

② 边缘:窗口聚合 + Merkle 锚定

import hashlib
def _h(b): return hashlib.sha256(b).digest()

def merkle_root(leaves):              # leaves: 已规范化的样本字节串列表
    if not leaves: return None
    lvl = [_h(x) for x in leaves]
    while len(lvl) > 1:
        if len(lvl) % 2: lvl.append(lvl[-1])   # 奇数复制最后一个
        lvl = [_h(lvl[i] + lvl[i+1]) for i in range(0, len(lvl), 2)]
    return lvl[0].hex()

def build_anchor(samples):            # 一个 15 分钟窗口
    leaves = [canonical(s) for s in samples]
    temps  = [s["temp"] for s in samples]
    return {
      "period_start": samples[0]["ts"], "period_end": samples[-1]["ts"],
      "sample_count": len(samples),
      "t_min": min(temps), "t_max": max(temps),
      "t_avg": round(sum(temps)/len(temps), 2),
      "excursion_count": sum(1 for t in temps if t < LO or t > HI),
      "merkle_root": merkle_root(leaves),
      "raw_uri": f"s3://coldchain/{SHIPMENT}/{samples[0]['ts']}.jsonl",
    }
# 之后由 anchor.py 签名并调用 TempOracle.submitAnchor,落库前先写本地 outbox 表保证不丢

③ 合约:异常判定与自动定责(核心逻辑片段)

function evaluate(bytes32 shipmentId) external returns (address liable, uint256 ratioBp) {
    Shipment storage s = shipments[shipmentId];
    require(s.status == Status.CLOSED, "not closed");

    // 找出累计超限时长最长的一段(段由交接事件切分)
    uint256 worst; uint16 worstSeg;
    for (uint16 i = 0; i < s.segCount; i++) {
        uint256 d = excursionSeconds(shipmentId, i);
        if (d > worst) { worst = d; worstSeg = i; }
    }
    if (worst == 0) return (address(0), 0);          // 全程达标,不赔

    Rule storage r = rules[s.ruleVersion];   // 规则版本化,避免事后改规则
    if (worst < r.toleranceSec) return (address(0), 0);  // 容差内视为正常(开门卸货等)

    liable   = s.segParty[worstSeg];
    ratioBp  = uint256(worst) * 10000 / totalSeconds(shipmentId);
    emit ClaimSettled(shipmentId, liable, ratioBp, s.ruleVersion);
}

④ 对外验证:任何人可验,但看不到别人的数据

# FastAPI:扫码验真接口——只回答"是/否 + 时间",不返回明细
@app.post("/verify")
def verify(file: UploadFile, shipment_id: str = Form(...)):
    raw = file.file.read()
    dg  = hashlib.sha256(raw).hexdigest()
    rec = chain.call("TempOracle", "getAnchors", shipment_id)   # 链上锚定记录
    hit = [a for a in rec if a["report_hash"] == dg]
    return {
      "match": bool(hit),
      "anchored_at": hit[0]["ts"] if hit else None,
      "shipment": bool(rec),          # 运单是否存在
      "excursion": sum(a["excursion_count"] for a in rec),   # 只给次数不给曲线
    }

实施效果与成本(设计目标)

务必这样理解下表 "改造前"一栏是该行业公开资料中常见的量级描述,"目标"一栏是本方案的设计目标。真实数值取决于货值、路线、设备密度与参与方配合度,实施前需用基线数据重新测算,不要直接写进合同或对外材料。
指标改造前(常见量级)本方案目标达成路径
超温发现时延到货后数小时至数天≤ 60 秒边缘本地规则 + 即时通知
责任判定耗时数天至数周分钟级(自动)双签交接 + 链上记录自动比对
理赔结案周期30~60 天3~7 天规则合约 + 证据包自动生成
货损率行业普遍为千分之几到百分之几相对下降 30%~50%途中干预 + 责任清晰带来的行为改善
监管检查取证跨企业人工调取在线一键导出监管只读节点 + 证据链
上链成本—每运单数十次写入窗口聚合 + Merkle 批量锚定

成本构成:终端改造(安全芯片与固件,一次性)+ 边缘网关(每车/每库一台)+ 链节点服务器(每方 1~2 台)+ 平台与运维。最大的隐性成本往往不是技术,而是多方协调与规则谈判——"超温多久算责任""容差多少分钟"这些业务规则,比写代码更难达成一致。

边界:这套方案解决不了什么

传感器本身被骗

把探头放进保温杯、用冰袋贴住传感器,链会忠实地记录下一个"完美"的温度曲线。链保证的是记录未被改,不是测量对象真实。应对:多点布点(回风/送风/货箱中心)、开门与位移传感器交叉验证、随机飞行抽检、铅封与视频留存。

设备校准过期

未校准的探头数据同样"不可篡改",只是不可信。应对:链上记录校准证书编号与有效期,过期后该设备数据自动降级为"参考值",不参与判责。

系统可用性

链不宕机不代表业务不中断;MQTT、时序库、API 任何一环挂掉都会影响监控。应对:边缘自治(断网仍告警)、全链路监控与演练。

隐私与数据合规

位置轨迹属于敏感个人信息,跨境场景还涉及数据出境。应对:数据分级、链上只放哈希与假名 ID、访问授权留痕、必要时做数据出境评估。

治理不是技术问题

联盟链是"多中心"而非"无中心":节点谁运维、新成员怎么加入、争议如何仲裁、合约升级谁签字,都必须事先写进联盟章程。

不是所有数据都值得上链

把明细全灌上链是最常见的错误做法:成本飙升、性能崩塌、隐私外泄。坚持"摘要上链、明细链下、哈希锚定"。

未来可改进的空间

把改进按"能马上做 / 需要建设 / 需要生态"分三档,避免把远期愿景当成当前排期。

档位方向做法与预期收益
近期规则引擎外置与版本化 把容差、赔付比例等参数从合约代码里抽出来,做成可治理的参数表 + 版本快照,新增品类无需重新部署合约。
近期边缘智能降噪 在网关跑轻量模型识别"开门、化霜、探头脱落"造成的假告警,减少误报与无效上链,把运维注意力集中在真异常上。
近期全链路可观测 补齐设备在线率、签名失败率、锚定延迟、事件积压等 SLO 指标,把"链上不可篡改"与"系统真的在跑"分开度量。
中期设备身份升级为 DID + 可验证凭证 用 W3C DID 为每台设备发放去中心化标识,厂商签发"校准凭证""型号凭证"(VC)。设备跨企业、跨生态流动时,身份与资质可自带、可离线验证,不再依赖中心化注册表。
中期隐私保护:只证明"达标"不暴露明细 用零知识证明或 TEE 远程证明,向监管/客户证明"全程 2~8℃ 且超限累计 < X 分钟",而不泄露具体温度曲线与路线——解决"想自证清白又怕泄商业机密"的矛盾。
中期跨链与跨生态互通 通过跨链网关/中继,与药监追溯链、保险行业平台、海关与口岸系统互联,做到"一次上链、多处采信",避免企业重复报送。
中期参数化保险与再保联动 把理赔规则与保险产品条款对齐,接入共保体与再保,实现定责即赔付、自动分账;规则变更全程留痕可审计。
中期标准对齐降低对接成本 事件模型对齐 GS1 EPCIS 2.0、编码与温度要求对齐国标与 GSP,把"每个伙伴一套接口"变成"一套标准多处复用"。
远期数据要素化与收益分配 在确权与授权前提下,把脱敏后的温控数据作为数据资产参与流通;收益分配用合约自动执行。注意:国内严禁虚拟货币与相关炒作,任何激励都不得涉及代币发行交易,只能采用数据权益凭证、服务积分、合约分账等合规形式。
远期数字孪生与路径优化 用历史数据仿真不同路线、季节、冷机策略下的温度与能耗表现,反向优化配送计划与设备配置,从"记录合规"走向"预测与优化"。
远期AI 大模型结合 自然语言查询运单与异常、自动生成监管报送材料与事故归因报告、用多模态模型审验照片与视频证据,压缩人工审核工作量。
远期绿色低碳与 ESG 采用低能耗共识、边缘设备休眠调度,并把能耗与碳排核算结果上链,服务 ESG 披露与绿色供应链评估。
远期联邦学习联合风控 多方数据不出域,联合训练"超温风险预测模型",把风险识别前置到发车之前。

落地路线(12 周试点)

  1. 第 1–2 周 · 基线选定一条真实线路与一家货主,采集现有流程的耗时、争议点、数据格式作为基线指标;确定联盟章程与节点归属。
  2. 第 3–4 周 · 设备与签名完成终端固件与安全芯片签名改造,跑通"设备 → 网关 → 验签入库";验收标准:任何一条被篡改的样本都能被验签拦下。
  3. 第 5–6 周 · 链与合约四节点联盟链搭建,部署四个合约,完成权限与双签交接的单元测试;验收标准:模拟超温与交接,链上记录可完整还原时间线。
  4. 第 7–8 周 · 锚定与看板窗口聚合、Merkle 锚定、事件索引与看板上线;验收标准:明细与链上根哈希可交叉验证,任意样本可出证明。
  5. 第 9–10 周 · 告警与处置边缘规则、通知、处置工单闭环;验收标准:注入超温后 60 秒内触达责任人并形成工单。
  6. 第 11–12 周 · 理赔与复盘理赔合约接入,跑 1~2 次真实或模拟理赔;输出成本、耗时、问题的复盘报告与下一阶段规划。
试点的判断标准 不要以"上线了几条链"验收,而要看三件事:争议是否变少、定责是否变快、途中干预是否真的减少了货损。这三点成立,项目才值得扩到更多线路。

延伸资料