跳转至

ProgramValidationError

from cascaqit import ProgramValidationError

ProgramValidationError

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"

排查流程见结果与诊断。

to_error_ir

to_error_ir() -> ErrorIR

返回包含本异常类别、错误码及上下文的 ErrorIR。保留设置的 retryable 值,不触发重试。

to_diagnostic

to_diagnostic() -> DiagnosticsIR

返回供诊断列表展示的 DiagnosticsIR;完整来源、cause 和附带诊断保存在错误对象及其 ErrorIR 中。