All SeedStack exceptions extend BaseException which is a RuntimeException. This means that you are not required to catch framework exceptions although you can do so if needed.

All SeedStack exceptions display a detailed information report about the failure. Consider this example:

org.seedstack.seed.SeedException: [CORE] Unexpected exception

Unexpected exception during Seed startup or shutdown.


1. com.google.inject.ProvisionException: Unable to provision, see the following errors:
   1) Error injecting org.seedstack.seed.core.ConfigurationIT$Holder using
    Reason: [CORE] Unable to inject configuration value
     while locating org.seedstack.seed.core.ConfigurationIT$Holder
   1 error @(InjectorImpl.java:1025)

2. [CORE] Unable to inject value from configuration key 'missingProperty' in field 'configObject2' of class
   'org.seedstack.seed.core.ConfigurationIT.Holder'. @(ConfigurationMembersInjector.java:54)

3. [CORE] Missing mandatory configuration key 'missingProperty'. @(ConfigurationMembersInjector.java:48)

Ensure that the configuration key 'missingProperty' is present and that the configuration source is correctly detected.

Online information


You can find the following information in this exception report:

  • The exception type: SeedException.
  • The module and the error code: CORE and Unexpected exception.
  • The textual description of the error: «Unexpected exception during Seed startup or shutdown».
  • A list of causes which is built from the Java exception chaining mechanism:
    • A Guice ProvisionException which occurred when trying to inject a class,
    • A SeedException which occurred when the configuration custom injector failed to the configObject2 field,
    • Another SeedException which occurred because the missingKey configuration key was mandatory and is missing.
  • The fix which is an advice on how to fix the root cause, i.e. the missing configuration key.
  • The online information which is an URL pointing to a Web resource related to the root cause.
  • The detailed stacktrace of the chained exceptions.

On this page