Skip to main content

Module code

Module code 

Source
Expand description

规范 6.1 章的错误码常量。

Constants§

ALL
全部错误码(测试矩阵与 --list-codes 使用)。
BUNDLE_SUFFIX
根目录名未以 .str 结尾。
DEEP_TREE
分支树深度超过 deep_tree_warn
DEPTH_EXCEEDED
分支树深度超过 max_depth
DOTFILE
出现非 ._meta / .lock 的点文件。
ENTRY_ID_MISMATCH
entries[].id 与子目录名不一致。
ENTRY_ROLE_DEPTH
父级 entries[].role 与子目录实际内容或深度不符。
ID_DUP
同一 bundle 内出现重复分支 id
ID_MISMATCH
id 与所在目录名不一致。
ID_NOT_UUID
分支目录名不是合法 UUID。
ID_VERSION
UUID 版本与 policies.id_version 不符。
KIND_DEPTH
kind 与所在深度不符。
KIND_INVALID
kind 非法。
LARGE_ASSET
单文件超过 large_asset_bytes
MANIFEST_DIGEST_MISSING
文件类条目缺少 size / sha256
MANIFEST_DUP
entries[].path 重复。
MANIFEST_GHOST
entries 登记但磁盘不存在。
MANIFEST_GHOST_W
manifest = advisory 时的幽灵条目。
MANIFEST_HASH
size / sha256 与实际不符。
MANIFEST_HASH_W
manifest = advisory 时的指纹不符。
MANIFEST_MISSING
磁盘存在但 entries 未登记。
MANIFEST_MISSING_W
manifest = advisory 时的未登记条目。
META_MISSING
分支目录缺失 ._meta
NO_SUMMARY
summary
NO_TYPE
type
OPTIONAL_MISSING
optional: true 的条目实际缺失。
PARSE
._meta 非法 TOML / 编码非 UTF-8 / 含 BOM / 时间未带时区偏移。
REF_CYCLE
refs 关联图成环。
REF_NO_TARGET
refs[].target 无法解析。
REF_SELF
refs[].target 指向自身。
RESERVED_NAME
业务条目以 ._ 开头。
REVISION_STALE
revision 非递增整数,或 updated_at 早于 created_at
ROOT_STRAY
ROOT 下出现既非分支目录也非保留名的条目。
SCHEMA_FAIL
payload 不满足其声明的 JSON Schema。
SCHEMA_FIELD
必填字段缺失 / 类型不符 / 未知字段。
SPEC_UNSUPPORTED
str 主版本不受支持。