FAQ: WebSocket/STOMP не работает (Safari скачивает iframe.html)

Симптомы

• 403/400 на GET /stomp/** в UI.
• В логах backend: DefaultHandshakeHandler: "Handshake failed due to invalid Upgrade header: null".
• SockJS уходит в fallback и скачивает /stomp/iframe.html (в Safari).

Причина

Используется обычный NGINX (VM) без WebSocket-прокси (нет Upgrade/Connection: upgrade, не включён HTTP/1.1, нет отдельного location для /stomp/**).

Решение

Добавить отдельный блок для /stomp/**:

location /stomp/ {
    proxy_pass http://unibpm/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_read_timeout 86400;
}