---
title: "Probleemoplossing"
space: "Frappe Framework"
url: "https://www.prilk.com/nl/docs/frappe-framework/probleemoplossing"
updated: "2026-05-14"
---

## 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**.