如何使用Cerberus获取YAML校验错误对应的行号？

Cerberus 原生不提供获取校验错误对应YAML行号的配置或能力。Cerberus的校验对象是YAML解析完成后生成的Python原生字典，解析阶段结束后原始文本的位置信息已经被丢弃，框架本身不感知源文件的行号映射关系。

要实现带行号的错误提示，核心是在YAML解析阶段保留字段和行号的映射关系，再和Cerberus返回的错误字段做匹配拼接，具体步骤：

• 替换默认YAML加载器，使用自定义构造逻辑，在解析每个节点时记录节点值、字段路径对应的原始行号，存入独立映射表
• 按原有逻辑完成Cerberus校验，拿到所有出错的字段及对应错误提示
• 遍历错误字段，从预存的行号映射表中取出对应行号，追加到错误提示文本末尾，生成最终带定位信息的错误结果

import yaml
from cerberus import Validator

# 存储值和对应行号的映射表
line_mapping = {}
class LineLoader(yaml.SafeLoader):
    pass

def record_line_scalar(node):
    # 自定义标量构造逻辑，记录每个值对应的行号
    # PyYAML行号从0开始计数，+1匹配常规编辑器显示的行号，可根据文本起始格式调整偏移量
    value = LineLoader.construct_scalar(node)
    line_mapping[value] = node.start_mark.line + 1
    return value

# 为常用标量类型绑定行号记录逻辑
LineLoader.add_constructor('tag:yaml.org,2002:str', record_line_scalar)
LineLoader.add_constructor('tag:yaml.org,2002:int', record_line_scalar)
LineLoader.add_constructor('tag:yaml.org,2002:float', record_line_scalar)
LineLoader.add_constructor('tag:yaml.org,2002:bool', record_line_scalar)

# 预定义Schema（注意YAML缩进格式，原示例缩进有误已修正）
schema_text = '''
name:
  type: string
age:
  type: integer
  min: 10
'''
# 待校验YAML内容
input_text = '''
name: Little Joe
age: 5
'''

# 加载Schema和待校验内容，加载待校验内容时自动记录行号
schema_yaml = yaml.safe_load(schema_text)
input_yaml = yaml.load(input_text, Loader=LineLoader)

# 执行常规校验
v = Validator(schema_yaml)
v.validate(input_yaml)

# 拼接行号信息到错误提示
errors_with_line = {}
for field, err_msgs in v.errors.items():
    field_value = input_yaml.get(field)
    line_num = line_mapping.get(field_value, "unknown")
    errors_with_line[field] = [f"{msg}..error found at line number {line_num}" for msg in err_msgs]

print(errors_with_line)
# 输出结果: {'age': ['min value is 10..error found at line number 2']}

如果需要处理多层嵌套的YAML结构，只需要扩展自定义Loader的构造逻辑，按完整字段路径（比如user.age）记录行号即可适配复杂场景。

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