#Troubleshooting

Start from the smallest read-only diagnostic that can confirm the failing layer.

#A module route is missing

Confirm the module is in the tenant module list, enabled in persisted module settings, and has all dependencies active. Then clear the application cache.

#A page returns an error

Inspect the persistent application log and the development debug tools. Do not expose request objects, credentials, tenant configuration, or stack traces to public users.

#A worker appears idle

Run the topology diagnostic from Queue operations and compare the expected worker identifiers with recent heartbeats.

#Documentation validation fails

Run php bin/console documentation:validate. Fix manifest errors, broken doc: links, unsafe URLs, missing headings, and locale gaps before deployment.