Er gaat iets mis

Plak je foutmelding in het zoekveld hieronder, of klik op je probleem om de oplossing te zien. De koppen volgen de hoofdstukken van de cursus; fouten die in elk hoofdstuk kunnen voorkomen, staan onderaan bij Algemeen.

0 problemen. Typ / om te zoeken.

Je eerste server

De term 'fastapi' wordt niet herkend (fastapi: command not found)

In PowerShell op Windows staat er:

fastapi : De term fastapi wordt niet herkend als de naam van een cmdlet, functie, scriptbestand of uitvoerbaar programma.

In een Engelse Windows is dat The term 'fastapi' is not recognized as the name of a cmdlet, en op een Mac fastapi: command not found.

Oorzaak: FastAPI is niet geïnstalleerd in de omgeving waar je terminal nu in werkt.

Oplossing: check eerst of je (.venv) vooraan je terminalregel ziet. Zie je het niet, open dan de terminal van VS Code (Terminal → New Terminal) en kijk daar; wat je doet als het daar ook ontbreekt, staat bij ModuleNotFoundError hieronder. Installeer daarna in die terminal:

python -m pip install "fastapi[standard]"

Meer uitleg: Installatie

Path does not exist main.py

De server start niet, en onder Starting FastAPI in development mode staat:

Path does not exist main.py

Oorzaak: fastapi dev main.py zoekt main.py in de map waarin je terminal nu staat, en daar is hij niet. Je terminal staat in een andere map, of je bestand heet anders, zoals Main.py of main.py.txt.

Oplossing: kijk naar het pad vóór je prompt. Is dat niet je projectmap, open dan je project opnieuw met code . vanuit je projectmap en gebruik de terminal van VS Code (Terminal → New Terminal). Staat main.py in de Explorer links met precies die naam, dan start de server.

# FOUT - de terminal staat in de map erboven
PS C:\Users\jij\Documenten> fastapi dev main.py

# GOED - de terminal staat in je projectmap
PS C:\Users\jij\Documenten\fullstack-project> fastapi dev main.py

Meer uitleg: Installatie

Je drukt op de afspeelknop van VS Code, en er start geen server

In de terminal verschijnt een regel met python.exe en main.py, en direct daarna weer de prompt. Er staat geen foutmelding en geen adres.

Oorzaak: de afspeelknop rechtsboven draait python main.py. Python leest je bestand, maakt app aan en is dan klaar: niets in main.py start een server. Dat doet fastapi dev.

Oplossing: start je server in de terminal, niet met de afspeelknop:

fastapi dev main.py

Meer uitleg: Je eerste endpoint

ModuleNotFoundError: No module named 'fastapi'

ModuleNotFoundError: No module named 'fastapi'

Oorzaak: je virtual environment is niet actief, dus Python kijkt in de verkeerde map naar geïnstalleerde pakketten.

Oplossing: open je project in VS Code met code . vanuit je projectmap en werk in de terminal van VS Code (Terminal → New Terminal); die zet de venv zelf aan. Lukt dat niet, activeer hem dan met de hand en check dat (.venv) in je terminal verschijnt:

# Windows
.venv\Scripts\activate

# Mac/Linux
source .venv/bin/activate

Zegt PowerShell dan dat het script niet kan worden geladen omdat het uitvoeren van scripts is uitgeschakeld (in een Engelse Windows: running scripts is disabled on this system), dan blokkeert Windows het handmatig activeren. Ga dan terug naar de terminal van VS Code; wat je daar moet controleren staat bij problemen bij het installeren.

Meer uitleg: Installatie

Poort 8000 is bezet (WinError 10048, Address already in use)

Op Windows eindigt de melding met:

[WinError 10048] Elk socketadres (protocol/netwerkadres/poort) kan normaal slechts één keer worden gebruikt

In een Engelse Windows staat er only one usage of each socket address, en op een Mac Address already in use.

Oorzaak: er draait al een server op poort 8000, meestal een vorige fastapi dev in een andere terminal die je vergeten bent.

Oplossing: stop die andere server met Ctrl+C in zijn terminal, of sluit die terminal. Of start op een andere poort:

fastapi dev main.py --port 8001

Meer uitleg: Kijken wat de browser doet, waar je de server met Ctrl+C stopt.

In de terminal staat GET /favicon.ico 404

▕  127.0.0.1:52341 - "GET /favicon.ico HTTP/1.1" 404

Oorzaak: de browser vraagt bij een nieuwe site uit zichzelf om /favicon.ico, het icoontje voor op het tabblad. Jouw server heeft geen endpoint voor dat adres, dus antwoordt hij met 404.

Oplossing: niets, er is niets mis. Je eigen pagina's werken wel.

Meer uitleg: Kijken wat de browser doet

De pagina laadt niet: ERR_CONNECTION_REFUSED of ERR_SSL_PROTOCOL_ERROR

De browser zegt dat de site niet bereikbaar is, met onderaan een van deze twee codes:

ERR_CONNECTION_REFUSED
ERR_SSL_PROTOCOL_ERROR

Oorzaak: de browser praat niet met je server. Bij ERR_CONNECTION_REFUSED draait er geen server: hij is gestopt, of nooit gestart. Bij ERR_SSL_PROTOCOL_ERROR probeert de browser https, en je server spreekt alleen http. In de terminal staat dan:

▕  Invalid HTTP request received.

Oplossing:

1. Kijk in de terminal of de server nog draait. Staat de prompt er weer, start hem dan opnieuw met fastapi dev main.py
2. Typ het adres helemaal uit: http://127.0.0.1:8000, met http en niet https

Meer uitleg: Kijken wat de browser doet

NameError: name 'app' is not defined

De server start niet, en onderaan de melding staat:

NameError: name 'app' is not defined

Oorzaak: je endpoint staat bóven de regel app = FastAPI(). Python leest je bestand van boven naar beneden, dus bij @app.get(...) bestaat app nog niet.

Oplossing: zet app = FastAPI() bovenaan, direct na de imports, en alle endpoints eronder:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"bericht": "Hallo"}

Meer uitleg: Je eerste endpoint

De pagina blijft laden, en er verschijnt niets

Het tabblad draait en draait, zonder foutpagina. In de terminal staat onderaan een foutmelding, bijvoorbeeld:

NameError: name 'HTMLResponse' is not defined

Oorzaak: je sloeg main.py op met een fout erin. fastapi dev probeert opnieuw te starten, loopt op de fout vast en wacht tot je weer opslaat. De poort blijft bezet, dus de browser krijgt verbinding maar nooit een antwoord.

Oplossing: lees de onderste regel in de terminal, los de fout op en sla op. De server start dan vanzelf, en na het herladen verschijnt je pagina. Een NameError op een naam als HTMLResponse of FileResponse betekent meestal dat de import ontbreekt. In welke regel een naam hoort, staat bij NameError: name '...' is not defined onder Algemeen:

# FOUT
from fastapi.responses import FileResponse

# GOED
from fastapi.responses import FileResponse, HTMLResponse

Meer uitleg: Je eerste endpoint

Je past een endpoint aan, maar de browser toont nog het oude antwoord (twee keer hetzelfde pad)

Oorzaak: er staan twee endpoints met hetzelfde pad in je main.py, bijvoorbeeld twee keer @app.get("/test"). FastAPI geeft geen foutmelding, maar gebruikt altijd de eerste. Wat je aan de tweede verandert, zie je nooit.

Oplossing: zoek in je main.py (Ctrl+F) op het pad en geef elk endpoint een eigen pad.

# FOUT - de tweede wordt nooit gebruikt
@app.get("/test")
async def test1():
    return {"bericht": "Eerste"}

@app.get("/test")
async def test2():
    return {"bericht": "Tweede"}

# GOED - elk endpoint een eigen pad
@app.get("/test")
async def test1():
    return {"bericht": "Eerste"}

@app.get("/test2")
async def test2():
    return {"bericht": "Tweede"}

Meer uitleg: Je eerste endpoint

Endpoints die eerst werkten, geven ineens Not Found (twee keer app = FastAPI())

{"detail":"Not Found"}

Oorzaak: er staat een tweede app = FastAPI() in je main.py, vaak omdat je een voorbeeld met de regel erbij hebt geplakt. Die maakt een nieuwe, lege app. De endpoints boven die regel hangen aan de oude app, en die gebruikt de server niet meer.

Oplossing: laat één app = FastAPI() staan, bovenaan, direct na de imports. Haal de tweede weg.

Meer uitleg: Je eerste endpoint

Het tabblad Netwerk is leeg, of mist het verzoek dat je zoekt

Oorzaak: Netwerk laat alleen zien wat het heeft opgenomen, en alleen wat door het filter komt. Daarom is de lijst de ene keer leeg en de andere keer niet.

Oplossing: loop deze vier langs.

1. Open het tabblad vóór je de pagina laadt, of herlaad met het tabblad open
2. Zet Logboek behouden (Preserve log) aan als je een formulier verstuurt of naar een andere pagina gaat: anders wist elke nieuwe pagina de lijst
3. Klik op Alle (All) in de rij soorten en maak het zoekvak leeg: een filter als Fetch/XHR blijft staan tot je hem uitzet
4. Kijk of het rondje linksboven rood is; grijs betekent dat opnemen uit staat (Ctrl+E zet het aan en uit)

Meer uitleg: Kijken wat de browser doet

Losse pagina's en routes

HTML wordt als tekst getoond, tussen aanhalingstekens en met \n erin

Oorzaak: zonder response_class=HTMLResponse maakt FastAPI JSON van je string. De browser toont dan één regel tussen aanhalingstekens, met \n waar jij een nieuwe regel begon, zoals "\n <!DOCTYPE html>\n <html>...".

Oplossing:

# FOUT - toont HTML als tekst
@app.get("/pagina")
async def pagina():
    return "<h1>Hallo</h1>"

# GOED - toont HTML als pagina
@app.get("/pagina", response_class=HTMLResponse)
async def pagina():
    return "<h1>Hallo</h1>"

Meer uitleg: HTML tonen

500 Internal Server Error, en in de terminal: RuntimeError ... does not exist

▕  127.0.0.1:54164 - "GET / HTTP/1.1" 500
RuntimeError: File at path static/pages/home.html does not exist.

Oorzaak: het endpoint bestaat wél, maar het bestand dat FileResponse moet sturen niet. Daarom krijg je een 500 en geen 404: de fout zit aan de serverkant, dus kijk in je terminal.

Oplossing: check of het bestand echt op die plek staat, met precies die naam (hoofdletters tellen). Het pad is relatief aan de map waar je fastapi dev startte, dus start de server vanuit je projectmap.

Meer uitleg: HTML in bestanden

404 Not Found bij het openen van een pagina

In de browser staat {"detail":"Not Found"}, en in de terminal:

▕  127.0.0.1:52344 - "GET /about.html HTTP/1.1" 404

Oorzaak: het endpoint bestaat niet. De URL die je opvraagt komt met geen enkele @app.get(...) in je main.py overeen: een typfout in de link, of het endpoint is nooit gemaakt.

Oplossing: vergelijk de URL in de adresbalk letter voor letter met het pad in je decorator. Vaak zit de fout in een link naar het bestand in plaats van naar het endpoint:

<!-- FOUT - de browser zoekt een endpoint /about.html, dat bestaat niet -->
<a href="about.html">Over mij</a>

<!-- GOED - het endpoint uit je main.py -->
<a href="/about">Over mij</a>

Meer uitleg: Links tussen pagina's

CSS en afbeeldingen

De server start niet: Directory 'static' does not exist

Onderaan de melding staat:

RuntimeError: Directory 'static' does not exist

Oorzaak: app.mount("/static", StaticFiles(directory="static"), ...) zoekt bij het starten een map static in de map waar je fastapi dev startte, en die is er niet. Dat gebeurt in een nieuwe projectmap, zoals de map van een reeks in Veiligheid, als je main.py maakt vóór de map static. Of je startte de server vanuit een andere map.

Oplossing: maak de map static naast main.py, of start de server vanuit je projectmap. Een lege map is genoeg om te starten.

je-project/
├── main.py
└── static/

Meer uitleg: CSS in een eigen bestand (static files)

CSS werkt niet / styling is weg

Oorzaak: de browser kan het CSS-bestand niet ophalen. De static-map is niet gekoppeld, of het pad in je <link> wijst ernaast.

Oplossing:

1. Staat app.mount("/static", StaticFiles(directory="static"), name="static") in je code?
2. Staat je CSS-bestand in static/css/style.css?
3. Staat in je HTML: <link rel="stylesheet" href="/static/css/style.css">?
4. Herstart de server en herlaad zonder cache (Ctrl+Shift+R, zie Wijzigingen zijn niet zichtbaar, hieronder)

Open http://127.0.0.1:8000/static/css/style.css rechtstreeks: zie je je CSS, dan ligt het aan de <link>; een 404, dan aan het pad of de mount.

Meer uitleg: CSS in een eigen bestand (static files)

Wijzigingen zijn niet zichtbaar

Oorzaak: de browser toont zijn eigen bewaarde kopie van de pagina (de cache), of de server draait nog met je oude code. Welke van de twee het is, zie je zo: druk op F12, kies het tabblad Netwerk en herlaad. Staat bij Grootte (schijfcache) of (geheugencache), dan heeft de browser de server niet eens gevraagd; de status is dan ook 200, dus kijk naar Grootte. Staat er een echt aantal bytes en is het bestand toch oud, dan draait de server met oude code.

Oplossing:

1. Herlaad zonder cache: met de ontwikkelaarstools open, rechtermuisknop op de herlaadknop en Cache wissen en geforceerd opnieuw laden (Empty Cache and Hard Reload), of Ctrl+Shift+R
2. Zet in het tabblad Netwerk het vinkje Cache uitzetten aan zolang je werkt
3. Herstart de server (Ctrl+C, dan opnieuw fastapi dev main.py)
4. Check of je het juiste bestand hebt aangepast

Meer uitleg: Als je wijziging niet doorkomt

Afbeelding laadt niet (broken image)

Oorzaak: het pad in src komt niet overeen met de plek van het bestand in je static-map.

Oplossing:

1. Staat de afbeelding in de map static?
2. Klopt de bestandsnaam precies, met hoofdletters en al? Windows verbergt vaak de extensie: een bestand dat kat.jpg lijkt, heet soms kat.jpg.jpg of kat.jpeg. Zet in de Verkenner bij Beeld het vinkje Bestandsnaamextensies aan om de echte naam te zien.
3. Klopt het pad in src="/static/foto.jpg"?
4. Staat app.mount("/static", ...) in je code?

Meer uitleg: Afbeeldingen tonen

Templates en formulieren

TemplateNotFound

jinja2.exceptions.TemplateNotFound: 'dobbelsteen.html' not found in search path: 'templates'

Oorzaak: Jinja2 zoekt het bestand in de map die je bij Jinja2Templates(directory=...) opgaf, en vindt het daar niet.

Oplossing:

1. Staat je template in de templates-map, naast main.py?
2. Klopt de bestandsnaam in TemplateResponse(request, "bestand.html", ...) precies? Geef alleen de naam door, zonder templates/ ervoor
3. Staat templates = Jinja2Templates(directory="templates") in je code?

Meer uitleg: Templates met Jinja2

Template variabele toont niets

Oorzaak: Jinja2 vult alleen in wat je meestuurt in het dictionary. Een naam die daar niet in zit, blijft leeg, zonder foutmelding.

Oplossing:

# FOUT - naam niet meegestuurd
return templates.TemplateResponse(request, "pagina.html", {})

# GOED - naam meegestuurd
return templates.TemplateResponse(request, "pagina.html", {"naam": naam})

Check ook dat de naam in {{ naam }} precies gelijk is aan de sleutel in het dictionary.

Meer uitleg: Templates met Jinja2

TypeError: unhashable type: 'dict'

TypeError: unhashable type: 'dict'

Oorzaak: je gebruikt de oude volgorde, waarin request ín het dictionary staat. Die kom je online nog overal tegen, maar hij werkt niet meer. Je bestandsnaam belandt dan op de plek van request en je dictionary op de plek van de bestandsnaam, dus FastAPI zoekt een template met een dictionary als naam.

Oplossing: zet request vooraan:

# FOUT - oude schrijfwijze
return templates.TemplateResponse("pagina.html", {"request": request, "naam": naam})

# GOED - request vooraan
return templates.TemplateResponse(request, "pagina.html", {"naam": naam})

Meer uitleg: Templates met Jinja2

422 Unprocessable Entity (of 422 Unprocessable Content)

In de browser staat een antwoord als dit:

{"detail":[{"type":"missing","loc":["body","naam"],"msg":"Field required","input":null}]}

En in de terminal:

▕  127.0.0.1:54152 - "POST /gastenboek HTTP/1.1" 422

In Netwerk staat bij Headers de statuscode 422 Unprocessable Content, of met een Python ouder dan 3.13 422 Unprocessable Entity. Het is dezelfde fout.

Oorzaak: FastAPI verwacht een waarde die niet binnenkomt, of niet in het goede type. loc zegt waar hij zocht, en het tweede woord is de naam die hij niet vond:

• "body": een formulierveld. De name in je HTML is anders dan de parameter in Python, het veld mist een name, of het veld is leeg verstuurd. Een leeg veld telt bij Form(...) als ontbrekend
• "query": een parameter na het vraagteken in de URL. Die staat niet in de URL, of je parameter heet anders dan de naam tussen de accolades in het pad; dan zoekt FastAPI hem na het vraagteken
• "query" met "request": je schreef request zonder type. Een parameter zonder : Request erachter leest FastAPI als query-parameter. Schrijf request: Request
• "path" met "type":"int_parsing": je parameter is een int, en in de URL staat tekst, zoals bij /bericht-nummer/abc

Oplossing: maak de namen gelijk:

<input name="naam" required>      <!-- HTML -->

naam: str = Form(...)    # Python: moet ook "naam" heten

# FOUT - {sleutel} in het pad, key in de functie
@app.get("/bericht/{sleutel}")
async def bericht_detail(request: Request, key: str):

# GOED
@app.get("/bericht/{sleutel}")
async def bericht_detail(request: Request, sleutel: str):

Mag een query-parameter ontbreken, geef hem dan een standaardwaarde: term: str = "". Vergeet required op je <input> niet, dan verstuurt de browser geen leeg veld.

Meer uitleg: Een waarde na een vraagteken: query-parameters (wat loc zegt), Een formulier versturen (POST) en Eén route voor veel pagina's: path-parameters

405 Method Not Allowed

In de browser staat {"detail":"Method Not Allowed"}, en in de terminal bijvoorbeeld:

▕  127.0.0.1:54160 - "GET /verwijderen HTTP/1.1" 405

Oorzaak: het pad bestaat, maar niet voor deze soort verzoek. Er komt een GET binnen bij een @app.post, een POST bij een @app.get, of een DELETE bij een @app.post.

Oplossing: kijk in de terminal welk werkwoord binnenkwam, en zoek je geval op:

1. Je typte de URL in de adresbalk. Dat is altijd een GET, dus het endpoint moet @app.get(...) zijn.

2. Je verstuurde een formulier en de adresbalk toont ?naam=.... De <form> mist method="post", en zonder die regel verstuurt de browser een GET.

3. Je verstuurde een formulier en de 405 komt meteen daarna. In de terminal staat dan "POST /berichten HTTP/1.1" 405 na een regel met 307. Je redirect mist status_code=303. De standaard is 307, en die laat de browser je POST herhalen op de nieuwe URL, waar alleen een @app.get staat:

   # FOUT - stuurt 307, de browser herhaalt je POST op de nieuwe URL
   return RedirectResponse(url="/berichten")
   
   # GOED - stuurt 303, de browser doet een GET
   return RedirectResponse(url="/berichten", status_code=303)

4. Je klikte op een htmx-knop met hx-delete. Die stuurt een DELETE, dus het endpoint moet @app.delete(...) zijn en niet @app.post(...).

Meer uitleg: Een formulier versturen (POST), Doorsturen na opslaan (redirect) en htmx-recepten: formulier, verversen, verwijderen, zoeken

Gegevens opslaan (SqliteDict)

ModuleNotFoundError: No module named 'sqlitedict'

ModuleNotFoundError: No module named 'sqlitedict'

Oorzaak: het pakket is niet geïnstalleerd in de omgeving waar je server in draait.

Oplossing: check dat je (.venv) in de terminal ziet en installeer:

python -m pip install sqlitedict

Meer uitleg: Gegevens opslaan met SqliteDict

Je bericht is meteen weg, of weg na herstarten (db.commit vergeten)

Oorzaak: zonder db.commit() schrijft de database je wijziging nooit naar het bestand. Zodra het with-blok sluit, is hij weg. Daarom zie je hem al bij het volgende verzoek niet, ook zonder herstart: /berichten opent de database opnieuw en vindt niets.

Oplossing:

# FOUT - wijziging verdwijnt bij het sluiten
with SqliteDict("data.db") as db:
    db["key"] = "waarde"

# GOED - commit schrijft naar het bestand
with SqliteDict("data.db") as db:
    db["key"] = "waarde"
    db.commit()

Meer uitleg: Gegevens opslaan met SqliteDict

Je aanpassing aan een opgeslagen dictionary of lijst is weg (niet teruggezet)

Oorzaak: db["sara"] geeft een kopie van wat er in het bestand staat. Pas je die kopie aan, met db["sara"]["klas"] = "5B" of met append, dan verandert het bestand niet. Er komt geen foutmelding, en db.commit() helpt niet: voor de database is er niets gewijzigd.

Oplossing: haal de waarde op, pas hem aan en zet hem terug onder dezelfde sleutel:

# FOUT - de kopie verandert, het bestand niet
with SqliteDict("data.db") as db:
    db["sara"]["vakken"].append("biologie")
    db.commit()

# GOED - ophalen, aanpassen, terugzetten
with SqliteDict("data.db") as db:
    sara = db["sara"]
    sara["vakken"].append("biologie")
    db["sara"] = sara
    db.commit()

Meer uitleg: Een dictionary aanpassen: ophalen, aanpassen, terugzetten

KeyError bij uitlezen of verwijderen

In de browser staat Internal Server Error, en in de terminal eindigt de melding met de sleutel die niet bestaat:

KeyError: 'bericht_1767225600123456789'

Oorzaak: je vraagt met vierkante haken een sleutel op die niet in de database staat, of je verwijdert hem. Dat gebeurt bij een tikfout of een hoofdletter in de sleutel, bij een verkeerde sleutel in de URL, als iemand twee keer op Verwijderen klikt, en bij een eerste bezoek zonder sessie. Staat de sleutel er wel in volgens je eigen script, dan draait dat script misschien in een andere map: daar maakt SqliteDict stil een nieuwe, lege database aan, met dezelfde bestandsnaam.

Oplossing: controleer eerst of de sleutel er is, of gebruik .get():

# FOUT - crasht als de sleutel niet bestaat
with SqliteDict("gastenboek.db") as db:
    bericht = db[sleutel]
    del db[sleutel]
    db.commit()

# GOED - get() geeft None als de sleutel niet bestaat
with SqliteDict("gastenboek.db") as db:
    bericht = db.get(sleutel)

# GOED - alleen verwijderen wat er is
with SqliteDict("gastenboek.db") as db:
    if sleutel in db:
        del db[sleutel]
        db.commit()

# GOED - bij sessies een lege sessie als er nog geen is
with SqliteDict("sessies.db") as sessies:
    mijn = sessies.get(sessie_id, {})

Meer uitleg: Gegevens opslaan met SqliteDict (een andere map), Bestaat de sleutel? in en get (in en get), Verwijderen met del (del), Eén item tonen: de sleutel uit de URL, Onthouden op de server: sessies en, voor een gewone dictionary, Eén route voor veel pagina's: path-parameters

Berichten opslaan

Er blijft maar één bericht over, of er verdwijnt er af en toe een

Oorzaak: elk bericht krijgt dezelfde sleutel, en een nieuw bericht overschrijft dan het vorige. Dat gebeurt met een vaste sleutel zoals "bericht", en ook met int(time.time()): twee berichten in dezelfde seconde krijgen dan dezelfde sleutel.

Oplossing: maak de sleutel met time.time_ns(), en zet import time bovenaan:

# FOUT - elk bericht onder dezelfde sleutel
sleutel = "bericht"

# GOED - elk bericht een eigen sleutel
sleutel = f"bericht_{time.time_ns()}"

Meer uitleg: Elk bericht bewaren: een eigen sleutel

AttributeError: 'NoneType' object has no attribute 'select'

AttributeError: 'NoneType' object has no attribute 'select'

Oorzaak: je gebruikt de data van je database buiten het with-blok, zonder er eerst een lijst van te maken. db.values() geeft geen lijst maar een generator: die haalt de rijen pas op als je erdoorheen loopt, en tegen die tijd is de database al dicht.

Oplossing:

# FOUT - de generator wordt pas buiten het with-blok gebruikt
with SqliteDict("gastenboek.db") as db:
    alle_berichten = db.values()

# GOED - list() haalt de data binnen het with-blok op
with SqliteDict("gastenboek.db") as db:
    alle_berichten = list(db.values())

Meer uitleg: Alles tonen: een for-lus in je template

Berichten tonen

TemplateSyntaxError: Unexpected end of template

jinja2.exceptions.TemplateSyntaxError: Unexpected end of template. Jinja was looking for the following tags: 'endfor' or 'else'. The innermost block that needs to be closed is 'for'.

Oorzaak: een {% for %} of {% if %} in je template gaat nooit dicht. Het bestand is op terwijl het blok nog openstaat.

Oplossing: elke {% for %} heeft een {% endfor %} nodig, elke {% if %} een {% endif %}:

<!-- FOUT - de lus gaat nooit dicht -->
{% for bericht in berichten %}
    <li>{{ bericht.naam }}</li>

<!-- GOED -->
{% for bericht in berichten %}
    <li>{{ bericht.naam }}</li>
{% endfor %}

Meer uitleg: Alles tonen: een for-lus in je template

Lijst blijft leeg terwijl er wel data in de database staat

Oorzaak: de lijst komt leeg of onder een andere naam bij de template aan. Jinja2 toont dan niets, zonder foutmelding.

Oplossing: check in deze volgorde:

1. Staat de naam in {% for bericht in berichten %} precies gelijk aan de sleutel in {"berichten": ...}?
2. Print alle_berichten in je endpoint. Zie je daar wél data, dan zit de fout in de template.
3. Staat er echt iets in je database? Open /berichten nadat je een bericht hebt verstuurd, niet ervoor.
4. Staat db.commit() in je POST-endpoint, binnen het with-blok? Zonder die regel is je bericht weg zodra het blok sluit (zie Je bericht is meteen weg, hierboven).

Meer uitleg: Alles tonen: een for-lus in je template

Elk bericht is een lege regel met alleen een dubbele punt

Oorzaak: je endpoint en je template passen niet bij elkaar. Dat kan op twee manieren, en ze zien er hetzelfde uit:

• Je endpoint stuurt list(db.items()), maar je template loopt met {% for bericht in berichten %}. Elk element is dan een paar van sleutel en bericht, en zo'n paar heeft geen naam.
• Je template loopt met {% for sleutel, bericht in berichten %}, maar je endpoint stuurt nog list(db.values()). Jinja2 pakt dan elk bericht zelf uit: sleutel wordt naam en bericht wordt het woord bericht. Je link wijst dan naar /bericht/naam, en later haalt Verwijderen niets weg.

Jinja2 laat de lege plekken leeg, zonder foutmelding.

Oplossing: stuur de sleutels mee met db.items(), en pak het paar uit in de lus:

# FOUT - geen sleutels
with SqliteDict("gastenboek.db") as db:
    alle_berichten = list(db.values())

# GOED - paren van sleutel en bericht
with SqliteDict("gastenboek.db") as db:
    alle_berichten = list(db.items())

<!-- FOUT - bericht is hier een paar -->
{% for bericht in berichten %}
    <li>{{ bericht.naam }}: {{ bericht.bericht }}</li>
{% endfor %}

<!-- GOED -->
{% for sleutel, bericht in berichten %}
    <li>{{ bericht.naam }}: {{ bericht.bericht }}</li>
{% endfor %}

Gebruikt je template de sleutel niet, dan mag het ook allebei zonder: db.values() met {% for bericht in berichten %}.

Meer uitleg: Eén item tonen: de sleutel uit de URL

In plaats van een foutpagina zie je JSON met status_code en detail (return in plaats van raise)

{"status_code":404,"detail":"Dit bericht bestaat niet","headers":null}

Oorzaak: je schrijft return HTTPException(...) in plaats van raise. Dan geeft je endpoint de fout terug als gewone data: de status is 200 en de browser toont de fout als JSON.

Oplossing:

# FOUT - status 200, met de fout als data
if bericht is None:
    return HTTPException(status_code=404, detail="Dit bericht bestaat niet")

# GOED - status 404, en de functie stopt hier
if bericht is None:
    raise HTTPException(status_code=404, detail="Dit bericht bestaat niet")

Meer uitleg: Een 404 sturen: als het item niet bestaat

Accounts

Naam of wachtwoord klopt niet, terwijl je het goede wachtwoord typt

{"detail":"Naam of wachtwoord klopt niet"}

Oorzaak: de naam is niet letter voor letter de naam van het account. Een sleutel in gebruikers.db telt elke letter mee: Sara is een ander account dan sara, en een spatie achter de naam telt ook. Bestaat het account helemaal niet, bijvoorbeeld omdat gebruikers.db weg is of je server in een andere map draait, dan krijg je dezelfde melding.

Oplossing: kijk met bekijk_db.py welke namen er in gebruikers.db staan, en typ de naam precies zo:

from sqlitedict import SqliteDict

with SqliteDict("gebruikers.db") as gebruikers:
    for naam in gebruikers.keys():
        print(repr(naam))

repr zet aanhalingstekens om de naam, zodat je ook een spatie aan het eind ziet.

Meer uitleg: Inloggen: een wachtwoord controleren

Uitbreiding: zonder herladen (htmx)

Na een klik staat de hele pagina in het doel (twee keer de kop)

Oorzaak: je endpoint geeft de hele pagina terug, of een omleiding. htmx volgt een omleiding net als de browser en zet alles wat binnenkomt in het doel van hx-target.

Oplossing: laat het endpoint alleen het stukje teruggeven dat in het doel hoort. Voor escape zet je from html import escape bovenaan:

# FOUT
return RedirectResponse(url="/berichten", status_code=303)

# GOED
return HTMLResponse(f"Bedankt, {escape(naam)}. Je bericht staat in het gastenboek.")

Meer uitleg: Zonder herladen met htmx

Er gebeurt niets na een klik, of het formulier verspringt met ?naam= in de adresbalk

Oorzaak: htmx zet alleen een geslaagd antwoord in de pagina. Er gebeurt dus niets als htmx niet geladen is, als hx-target naar een element wijst dat niet op de pagina staat, of als het verzoek mislukt.

Oplossing: open het tabblad Netwerk en klik nog een keer.

1. Geen nieuwe regel, en in de Console een rode regel met htmx:targetError: htmx is wel geladen, maar vindt het doel niet, en stuurt dan geen verzoek. Achter de melding staat wat er in je hx-target staat:

   htmx:targetError, #antwoord

   Staat er op de pagina geen element met id="antwoord", of mist het # in hx-target? Zet het element op dezelfde pagina als je knop of formulier, en begin hx-target met #.

2. Geen nieuwe regel en geen htmx:targetError, of een rode regel bij htmx.min.js: htmx is niet geladen. Zonder htmx zijn hx-get en hx-post attributen die de browser niet kent: een knop doet niets, en een formulier zonder method verstuurt hij als GET naar dezelfde pagina, met ?naam= in de adresbalk. Zet htmx.min.js in static/js/ en de script-tag in de <head>:

   <script src="/static/js/htmx.min.js"></script>

3. Een rode regel bij je eigen verzoek: 404 is een verkeerd pad in hx-get of hx-post, 405 een verkeerd werkwoord (zie 405 Method Not Allowed hierboven), 500 een fout in je endpoint (kijk in de terminal), (mislukt) een server die niet draait.

Meer uitleg: Zonder herladen met htmx en htmx-recepten: formulier, verversen, verwijderen, zoeken

Uitbreiding: JavaScript in de browser

Cannot read properties of null (reading 'addEventListener')

In de Console staat:

Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')

Oorzaak: je script draait voordat het element bestaat. Zonder defer voert de browser je script uit terwijl hij nog in de <head> zit, en vindt querySelector niets.

Oplossing:

<!-- FOUT - draait terwijl de browser nog in de head zit -->
<script src="/static/js/app.js"></script>

<!-- GOED - wacht tot de pagina er staat -->
<script src="/static/js/app.js" defer></script>

Staat defer er wel? Check dan of de id in je HTML precies gelijk is aan die in je querySelector, inclusief hoofdletters.

Meer uitleg: JavaScript erbij

Mijn JavaScript-bestand wordt niet geladen (rode regel in de Console)

Oorzaak: de browser kan het bestand niet vinden. Het staat op de verkeerde plek, het pad klopt niet, of de static-map is niet gekoppeld.

Oplossing:

1. Staat het bestand in static/js/?
2. Staat app.mount("/static", StaticFiles(directory="static"), name="static") in je main.py?
3. Begint het pad in je script-tag met een slash: src="/static/js/app.js"?

Open http://127.0.0.1:8000/static/js/app.js rechtstreeks in je browser. Zie je je code, dan ligt het aan de script-tag; krijg je een 404, dan aan het pad of de mount.

Meer uitleg: JavaScript erbij

Een bezoeker komt langs mijn controle in de HTML

Oorzaak: maxlength en required zijn instructies aan de browser, en de browser is van de bezoeker. Wie het formulier omzeilt, komt er zo langs.

Oplossing: wil je echt een grens, controleer dan óók in Python:

if len(bericht) > 80:
    raise HTTPException(status_code=400, detail="Bericht is te lang")

Meer uitleg: Server of browser?

Uitbreiding: onthouden (cookies en sessies)

Een KeyError bij sessies[sessie_id] staat bij KeyError bij uitlezen of verwijderen, onder Gegevens opslaan (SqliteDict).

De cookie wordt niet onthouden

Oorzaak: set_cookie staat op een ander antwoord dan het antwoord dat je returnt.

Oplossing:

# FOUT - de cookie zit op een antwoord dat je weggooit
antwoord = RedirectResponse(url="/berichten", status_code=303)
antwoord.set_cookie(key="naam", value=naam)
return RedirectResponse(url="/berichten", status_code=303)

# GOED - dezelfde variabele erin en eruit
antwoord = RedirectResponse(url="/berichten", status_code=303)
antwoord.set_cookie(key="naam", value=naam)
return antwoord

Meer uitleg: Onthouden met een cookie

De cookie is er wel, maar mijn endpoint krijgt hem niet

Oorzaak: FastAPI zoekt de cookie op onder de naam van je parameter. Heet je parameter anders dan je cookie, dan vindt hij niets en krijg je de standaardwaarde.

Oplossing: heet je cookie sessie_id, dan heet je parameter ook sessie_id:

# FOUT - cookie heet 'sessie_id', parameter heet 'sid'
async def gastenboek_form(request: Request, sid: str = Cookie(default="")):

# GOED
async def gastenboek_form(request: Request, sessie_id: str = Cookie(default="")):

Meer uitleg: Onthouden met een cookie

De cookie verdwijnt zodra ik de browser sluit

Oorzaak: zonder max_age maak je een cookie die alleen bestaat zolang de browser openstaat.

Oplossing: geef een houdbaarheid in seconden mee, bijvoorbeeld dertig dagen:

antwoord.set_cookie(key="naam", value=naam, max_age=60 * 60 * 24 * 30)

Meer uitleg: Onthouden met een cookie

Na het inloggen zie je weer het inlogformulier (Log eerst in)

Het inloggen lijkt te lukken: je komt terug op /gastenboek. Maar daar staat weer het inlogformulier, en wie toch een bericht stuurt, krijgt:

{"detail":"Log eerst in"}

Oorzaak: je server vindt bij het volgende verzoek geen sessie. Dat kan op twee manieren, en ze zien er hetzelfde uit. Kijk in het tabblad App bij Cookies welke het is:

• Staat er een sessie_id, dan ontbreekt sessies.commit() in /inloggen. De sessie verdwijnt zodra het with-blok sluit, en het id in je cookie hoort bij niemand.
• Staat er geen sessie_id, dan zet set_cookie de cookie op een ander antwoord dan het antwoord dat je returnt (zie De cookie wordt niet onthouden, hierboven).

Oplossing: schrijf de sessie weg, en return het antwoord waar de cookie op staat:

# FOUT - de sessie wordt nooit opgeslagen
with SqliteDict("sessies.db") as sessies:
    sessies[sessie_id] = {"naam": naam}

# GOED
with SqliteDict("sessies.db") as sessies:
    sessies[sessie_id] = {"naam": naam}
    sessies.commit()

antwoord = RedirectResponse(url="/gastenboek", status_code=303)
antwoord.set_cookie(key="sessie_id", value=sessie_id, max_age=60 * 60 * 24 * 30)
return antwoord

Meer uitleg: Onthouden op de server: sessies

Afronden

Je eigen foutpagina verschijnt, maar Netwerk zegt dat het gelukt is

Oorzaak: de TemplateResponse in je handler heeft geen status_code. Dan gaat je foutpagina terug met de standaardcode voor gelukt, en denken een script of een zoekmachine dat de pagina bestaat.

Oplossing: geef de statuscode mee:

# FOUT - de foutpagina komt terug als gelukt
return templates.TemplateResponse(request, "404.html", {"pad": request.url.path})

# GOED
return templates.TemplateResponse(request, "404.html", {"pad": request.url.path}, status_code=404)

Meer uitleg: Een eigen 404-pagina: een handler voor fouten

Sinds je eigen foutpagina geeft elk onbekend adres Internal Server Error

Onderaan in je terminal staat:

jinja2.exceptions.TemplateNotFound: '404.html' not found in search path: 'templates'

Oorzaak: je handler voor 404 vindt zijn template niet. Hij draait bij elke 404, dus elke 404 wordt een 500.

Oplossing: zet 404.html in de map templates, naast je andere templates, en geef alleen de bestandsnaam door:

templates.TemplateResponse(request, "404.html", {"pad": request.url.path}, status_code=404)

Meer uitleg: Een eigen 404-pagina: een handler voor fouten

Mijn klasgenoot kan niet bij mijn server

Oorzaak: je server luistert alleen naar je eigen computer, of jullie zitten niet op hetzelfde netwerk.

Oplossing: check in deze volgorde:

1. Draait je server met --host 0.0.0.0? Zonder dat luistert hij alleen naar je eigen computer.
2. Geef je het juiste adres door? 127.0.0.1 verwijst bij hem naar zijn eigen computer, niet naar die van jou. Zoek je adres met ipconfig (Windows, de regel IPv4-adres), ipconfig getifaddr en0 (macOS) of ip addr (Linux).
3. Zitten jullie op hetzelfde netwerk? Het gastennetwerk op school staat vaak los van het schoolnetwerk.
4. Vraagt je firewall om toestemming, sta die dan toe.

Meer uitleg: Laat het aan anderen zien

Online zetten

permission denied while trying to connect to the docker API

permission denied while trying to connect to the docker API at unix:///var/run/docker.sock

Oorzaak: je zit niet in de groep docker, of je logde nog niet opnieuw in sinds usermod. In WSL moet Ubuntu daarvoor helemaal opnieuw starten.

Oplossing: typ groups. Staat docker er niet bij, zet jezelf dan in de groep met sudo usermod -aG docker $USER. Sluit daarna in WSL alle terminals en typ in PowerShell wsl --terminate Ubuntu-24.04; op een server log je uit en weer in. Zet geen sudo voor docker: wat Docker dan in je mappen zet, is van root.

Meer uitleg: Online zetten: Docker installeren

port is already allocated

Bind for 0.0.0.0:8000 failed: port is already allocated

Oorzaak: poort 8000 van je computer is al bezet, meestal door een container die nog draait.

Oplossing: kijk met docker ps welke container de poort heeft, en stop hem met docker stop en zijn naam. Of kies een andere poort voor je computer: -p 8001:8000, of "127.0.0.1:8001:8000" in compose.yaml.

Meer uitleg: Online zetten: een container draaien

The container name is already in use

docker: Error response from daemon: Conflict. The container name "/gastenboek" is already in use

Oorzaak: er bestaat al een container met die naam, ook als hij gestopt is.

Oplossing: gooi de oude weg met docker rm -f gastenboek, en start opnieuw. Wat de container in een volume schreef, blijft bewaard; wat erin zelf stond, is weg.

Meer uitleg: Online zetten: op de achtergrond

sqlite3.OperationalError: unable to open database file (in een container)

sqlite3.OperationalError: unable to open database file

Oorzaak: je site draait als app, en die mag in /app niets maken. Een database staat nog niet in data/, of de map data bestaat niet.

Oplossing: zet elke SqliteDict("…") in main.py in data/, en zorg voor de regel os.makedirs("data", exist_ok=True). Bouw daarna opnieuw.

Meer uitleg: Online zetten: niet als root

sqlite3.OperationalError: attempt to write a readonly database

sqlite3.OperationalError: attempt to write a readonly database

Oorzaak: je zette een back-up terug met docker compose cp. Wat dat in een container zet, is van root; je site draait als app en mag de databases lezen, maar niet veranderen.

Oplossing: geef ze terug aan app, terwijl de container draait: docker compose exec -u root gastenboek chown -R app /app/data.

Meer uitleg: Online zetten: een back-up

found a tab character that violates indentation

yaml: line 3: found a tab character that violates indentation

Oorzaak: in compose.yaml staat een tab in plaats van spaties, op de regel die Compose noemt of de regel erna.

Oplossing: vervang de tab door spaties. Klik in VS Code rechtsonder op Tab Size en kies Indent Using Spaces.

Meer uitleg: Online zetten: alles in één bestand

404 page not found van Traefik

404 page not found

Oorzaak: Traefik kent geen gezonde site voor deze naam. Een tikfout in een label, een andere naam in Host(…) dan die je typte, op de server een .env die ontbreekt, of een container die (unhealthy) is.

Oplossing: kijk met docker compose ps of je site draait en gezond is, en met docker compose config | grep Host welke naam Compose echt gebruikt. Vergelijk je labels letter voor letter met die uit de les.

Meer uitleg: Online zetten: een voordeur met Traefik

Bad Gateway van Traefik

Bad Gateway

Oorzaak: Traefik weet welke container het is, maar krijgt geen antwoord. Vaak staat er een andere poort in het label dan 8000, of start je site niet.

Oplossing: controleer loadbalancer.server.port=8000, en kijk met docker compose logs in je project of je site draait.

Meer uitleg: Online zetten: een voordeur met Traefik

client version 1.24 is too old

Error response from daemon: client version 1.24 is too old. Minimum supported API version is 1.40

Oorzaak: een oude versie van Traefik praat met Docker op een manier die Docker 29 niet meer kent.

Oplossing: zet image: traefik:v3 in de compose.yaml van Traefik, en haal de nieuwste op met docker compose pull en docker compose up -d.

Meer uitleg: Online zetten: een voordeur met Traefik

no space left on device

no space left on device

Oorzaak: de schijf is vol, meestal door oude images: bij elke --build en elke pull blijft het vorige staan.

Oplossing: kijk met docker system df waar de ruimte zit, en ruim op met docker image prune. Typ nooit docker volume prune of docker system prune --volumes: die gooien ook volumes weg waar op dat moment geen container aan hangt, en daar staan je databases in.

Meer uitleg: Online zetten: bijwerken en opruimen

Algemeen

NameError: name '...' is not defined (een import of een parameter ontbreekt)

NameError: name 'Form' is not defined

Voor een module als time voegt Python 3.12 en nieuwer er een hint aan toe:

NameError: name 'time' is not defined. Did you forget to import 'time'?

Of de naam is er een uit je eigen functie:

NameError: name 'request' is not defined

Oorzaak: Python kent de naam niet. Bij Form of time ontbreekt een import: elke naam die je van FastAPI, sqlitedict of Python zelf gebruikt, moet bovenaan je bestand geïmporteerd staan. Bij request, of een andere naam die alleen in je eigen functie bestaat, ontbreekt een parameter: hij staat niet tussen de haakjes van async def. Dat gebeurt vaak als je een endpoint met FileResponse ombouwt naar TemplateResponse(request, ...). Staat de naam in een @app-regel of in de parameters, dan start de server niet; staat hij in de functie, dan gaat het pas mis bij het eerste verzoek, met een 500.

Oplossing: ontbreekt er een parameter, zet hem dan tussen de haakjes. Een import helpt daar niet:

# FOUT - request staat niet bij de parameters
@app.get("/naam")
async def toon_formulier():

# GOED
@app.get("/naam")
async def toon_formulier(request: Request):

Ontbreekt er een import, zoek de naam dan op in deze tabel en zet hem in de regel die erbij hoort. Staat die regel er al, dan komt de naam erbij, met een komma:

Naam	Regel bovenaan je bestand
FastAPI, Form, Request, Response, HTTPException, Cookie	from fastapi import …
HTMLResponse, FileResponse, RedirectResponse, JSONResponse	from fastapi.responses import …
StaticFiles	from fastapi.staticfiles import StaticFiles
Jinja2Templates	from fastapi.templating import Jinja2Templates
SqliteDict	from sqlitedict import SqliteDict
escape	from html import escape

# FOUT - Form wordt gebruikt, maar staat niet in de import
from fastapi import FastAPI, Request

# GOED
from fastapi import FastAPI, Form, Request

Response zelf staat in fastapi; de soorten antwoorden met een woord ervoor, zoals HTMLResponse, staan in fastapi.responses. Wat niet in de tabel staat, komt uit Python zelf of is voor een enkele les:

import random
import secrets
import time
from datetime import datetime

from fastapi.exception_handlers import http_exception_handler
from starlette.exceptions import HTTPException as StarletteHTTPException

In VS Code zie je een ontbrekende naam al voor je de server start, aan een kronkel eronder. Zet je cursor erop en druk op Ctrl+.: vaak stelt VS Code de import-regel dan voor.

Meer uitleg: Modules importeren

IndentationError of TabError

Onderaan de melding staat een van deze regels:

IndentationError: expected an indented block after function definition on line 7
IndentationError: unindent does not match any outer indentation level
IndentationError: unexpected indent
TabError: inconsistent use of tabs and spaces in indentation

Oorzaak: Python leest de structuur van je code aan het inspringen af, en ergens klopt dat niet. Een regel onder een def of with springt niet in, een regel springt verder of minder in dan de regels erboven, of er staan tabs en spaties door elkaar (dat is de TabError).

Oplossing: ga naar het regelnummer uit de melding en zet de regel precies onder de regels die bij hetzelfde blok horen, met vier spaties per niveau. Bij een TabError: druk in VS Code op Ctrl+Shift+P, typ Convert Indentation to Spaces en druk op Enter; dan zijn alle tabs spaties.

Meer uitleg: If en else