Python开发WoT设备描述目录：JSON-LD验证问题

问题概述 #

我在Python开发Web of Things（WoT）的Thing Description目录时，需要验证注册的JSON-LD格式Thing Description是否符合W3C Thing Description v1.1规范。使用jsonschema库的validate函数验证时，部分不符合规范的文档被误判为有效，怀疑是无法处理规范中的嵌套Schema；同时json.loads()转换为Python对象后，布尔值验证也存在问题。目前Eclipse的在线验证工具可正确验证，代码片段如下：

解决方案 #

1. 使用官方完整JSON Schema #

W3C WoT TD v1.1有官方提供的完整JSON Schema定义，不要自行拆分或修改。该Schema已处理好嵌套结构的$ref引用，直接使用官方文件能避免嵌套Schema解析问题。

2. 修复布尔值验证异常 #

json.loads()将JSON的true/false转为Python的True/False是正确行为，但验证出错可能是以下原因：

• 检查Schema中布尔字段的定义是否为"type": "boolean"，避免误写为字符串类型
• 使用jsonschema的新版验证器（如Draft202012Validator）代替默认旧版本，旧版本对类型约束的处理存在兼容性问题

3. 正确配置Schema引用解析 #

嵌套Schema的$ref未被正确解析是常见问题，可通过RefResolver指定基础URI确保所有引用被加载：

import json
from jsonschema import RefResolver
from jsonschema.validators import Draft202012Validator

# 加载官方TD v1.1 Schema文件
with open("wot-td-v1.1.schema.json", "r") as schema_file:
    td_schema = json.load(schema_file)

# 加载待验证的TD文档
with open("target-td.json", "r") as td_file:
    td_doc = json.load(td_file)

# 配置引用解析器，指定Schema的基础路径
resolver = RefResolver(
    base_uri="file:///your/path/to/wot-td-v1.1.schema.json",
    referrer=td_schema
)

# 执行验证并输出错误
validator = Draft202012Validator(td_schema, resolver=resolver)
validation_errors = list(validator.iter_errors(td_doc))

if validation_errors:
    for err in validation_errors:
        print(f"验证失败: {err.message} | 路径: {list(err.absolute_path)}")
else:
    print("TD文档符合W3C v1.1规范")

4. 替代方案：调用官方验证逻辑 #

如果Python的jsonschema仍存在兼容性问题，可参考Eclipse在线工具的底层实现（基于Node.js的wot-td-validator库），通过subprocess在Python中调用Node.js验证脚本，确保和在线工具的验证逻辑一致。

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