ProgramValidationError¶
from cascaqit import ProgramValidationError
程序、参数或载荷不符合校验要求时使用的异常。它同时继承 ValueError 和 CASCAQitError。
默认 category=validation、code=PROGRAM_VALIDATION_ERROR、stage=validation,severity 为 error,retryable 为 False。调用方可传 code、stage、object_path、suggestion 等覆盖字段;完整构造参数见 CASCAQitError。
通常先修正 object_path 指向的声明,再重新执行;仅重复提交同一非法程序不会消除校验错误。
from cascaqit import ProgramValidationError
error = ProgramValidationError("Example failure", object_path="program")
assert error.to_error_ir().category == "validation"
assert error.to_diagnostic().code == "PROGRAM_VALIDATION_ERROR"
排查流程见结果与诊断。
返回包含本异常类别、错误码及上下文的 ErrorIR。保留设置的 retryable 值,不触发重试。
返回供诊断列表展示的 DiagnosticsIR;完整来源、cause 和附带诊断保存在错误对象及其 ErrorIR 中。