Probleemoplossing

Probleemoplossing

Veelvoorkomende problemen en waar te zoeken.

"Permission Denied" op een document

1. Controleer dat een rol van de gebruiker read heeft op het DocType (Role Permissions Manager).
2. Controleer User Permissions — mogelijk beperkt tot specifieke records.
3. Controleer Share op het document — eenmalige toekenning kan nodig zijn.
4. Voor "submit"-acties specifiek: een rol kan read hebben zonder submit; bekijk de checkboxen per actie.

"DoesNotExistError"

Het gerefereerde record is verwijderd, of bestond nooit.

• Bekijk de Error Log voor de volledige traceback — die geeft het DocType aan.
• Controleer Document Naming Settings op typefouten in de Naming Series.
• Controleer of de gebruiker read-recht heeft op het gelinkte DocType (permissiefilter kan een record "niet-bestaand" maken vanuit hun view).

Data Import faalt stilletjes

Open Data Import → klik het mislukte item → bekijk de log. De reden per rij staat erbij. Veelvoorkomende oorzaken:

• Verplicht veld ontbreekt
• Link naar niet-bestaand record
• Verkeerd datatype voor de kolom

Mail vertrekt niet

1. Bevestig dat Email Account → Default Outgoing is ingesteld.
2. Test SMTP met bench --site mysite email-test --recipient=test@example.com.
3. Bekijk Email Queue voor status; SMTP-fouten staan daar.
4. Verifieer dat de firewall poort 587 / 465 niet blokkeert.

Scheduler draait niet

1. bench --site mysite show-pending-jobs — zoek vastgelopen jobs.
2. Bevestig dat het scheduler-proces draait (bench restart om te verversen).
3. Bekijk Scheduled Job Log op fouten.
4. Controleer dat enable_scheduler in common_site_config.json niet uit staat.

Trage performance

• Bekijk Slow Query Log (Frappe Cloud dashboard of MariaDB rechtstreeks).
• Zoek ontbrekende DB-indexen — meestal op filters in zware rapporten.
• Profileer een request: bench --site mysite enable_profile en laad de pagina; profileroutput komt in console-logs.

Migratie faalt

• Lees de traceback — meestal een custom-field-conflict of ontbrekend patch.
• bench --site mysite migrate --skip-failing om over te slaan en later opnieuw te draaien.
• Bij hopeloos vastlopen: herstel back-up en probeer opnieuw zonder de falende app.

Error Log is uw vriend

Bijna elke frameworkfout laat een record achter in Error Log met volledige traceback. Eerste plek om te kijken. System Manager → Error Log → filter op vandaag.