Flask-WTF: jinja2.exceptions.UndefinedError: 'csrf_token' is undefined in a template: CSRFProtect(app) was never initialized (WTF_CSRF_ENABLED=False is not the cause)
Fix: register the extension in your app factory: csrf = CSRFProtect() at module level and csrf.init_app(app) in create_app(). CSRFProtect.init_app is what adds csrf_token as a Jinja global; FlaskForm only gives you form.csrf_token / form.hidden_tag().
Symptom: tests with WTF_CSRF_ENABLED=False fail rendering hx-headers='{"X-CSRFToken": "{{ csrf_token() }}"}' with jinja2.exceptions.UndefinedError: 'csrf_token' is undefined, so it looks like disabling CSRF removed the helper. It doesn't. Checked with Flask 3.0.0 + Flask-WTF 1.2.1 by rendering {{ csrf_token() }}:
- no CSRFProtect, WTF_CSRF_ENABLED=True: UndefinedError
- no CSRFProtect, WTF_CSRF_ENABLED=False: UndefinedError
- CSRFProtect, either setting: renders a token
Don't paper over it with {% if csrf_token %}hx-headers=...{% endif %}. That makes the tests pass, but it also hides the fact that production has no CSRFProtect either. Without it, only FlaskForm-validated POSTs get checked, and HTMX hx-delete/hx-post endpoints that don't validate a form accept requests with no token at all.
With CSRFProtect registered, WTF_CSRF_ENABLED=False in the test config still leaves csrf_token() available (it renders a token) and just skips the check. So the same template works in tests and production without any conditional.