docs: PROBLEM-AND-SOLUTION, правила, история Connection:close, gitignore

2026-07-14 19:19:12 +04:00
parent 5e7319cd42
commit b3298b415e
5 changed files with 88 additions and 103 deletions
@@ -0,0 +1,23 @@
+# Waitress + Connection: close — hop-by-hop заголовок
+
+**Дата:** 2026-07-14  
+**Версия:** 0.0.21 → 0.0.22
+
+---
+
+## Ошибка
+
+`Connection` — hop-by-hop заголовок. Waitress (WSGI) запрещает его использовать в приложении (PEP 3333).
+
+```python
+# ❌ НЕЛЬЗЯ
+response.headers["Connection"] = "close"
+
+# Ошибка:
+AssertionError: Connection is a "hop-by-hop" header; it cannot be used by a WSGI application (see PEP 3333)
+```
+
+## Правило
+
+**Никогда не добавлять `Connection` заголовок в Flask/Waitress-приложении.**
+Нужно закрывать соединения — только через nginx (upstream keepalive) или uWSGI/gunicorn.