====== 16.4 Configuration Errors ======

[[fxdemo:05-part:start | Go To Top ]]

[[fxdemo:05-part:16-exception-handling:start | Return to Exception Handling ]]

[[dido:99_annexes:annex-b-terms-and-definitions:c:configuration|Configuration]] errors should fail early. [[dido:99_annexes:annex-b-terms-and-definitions:n:node|Nodes]], scripts, containers, and validation tools should validate required Configuration before they rely on it.

Configuration error handling should detect:

  - Missing required Configuration files.
  - Invalid Configuration format.
  - Missing required fields.
  - Invalid values.
  - Unsupported profile names.
  - Missing environment variables.
  - Invalid paths.
  - Invalid Topic names.
  - Invalid QoS profile references.
  - Invalid Node Identity or Node role values.
  - Conflicting Configuration values.

When a Configuration error occurs, the implementation should identify the Configuration source, the failing field or value where safe, and the reason the value is invalid. Error messages should avoid leaking secrets, credentials, or sensitive local values.

A Node that cannot validate required Configuration should publish Failed status where possible and exit. A script that cannot validate required Configuration should return a non-zero exit code. A container that starts with invalid Configuration should fail visibly rather than running in an undefined state.

----

<WRAP centeralign>

© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

</WRAP>