This section explains how the library rejects invalid descriptor sets and how to investigate runtime failures without guessing.
- Compile-Time Validation
Checks performed by
RegistryCompilerandDescriptorValidationPipelinebefore a registry is created. - Debug Validator
Graph-wide validation performed by
RegistryDebugValidatoragainst the compiled registry and real resolver. - Troubleshooting Exception-oriented guidance for common configuration and runtime mistakes.
- compilation fails before your application boots
- environment-specific bindings do not resolve as expected
- factory metadata looks correct in isolation but fails when the full graph is wired
- you need to map an exception message back to the descriptor or dependency that caused it