ShortURL breaks WebSocket (/websocket/... returns 404) — fix required in rewrite rule?

Help / Discuss
1

Hello,

ShortURL using UrlRewriteFilter as described in the official guide.
However, after applying the configuration, the endpoint /websocket/xwiki/netflux started returning 404, and WebSocket functionality stopped working.
My environment is nginx + Tomcat 10 + Java 21.

The guide provides the following rule:

<from>^/((authenticate|bin|resources|skins|asyncrenderer|rest|wiki|jcaptcha|webjars|job)/(.*)|robots\.txt)$</from>

After modifying it by adding websocket like this:

<from>^/((authenticate|bin|resources|skins|asyncrenderer|rest|wiki|jcaptcha|webjars|job|websocket)/(.*)|robots\.txt)$</from>

the WebSocket endpoint started working correctly again.

It seems the documentation might be missing this part.
If this is indeed an oversight, I would appreciate it if the guide could be updated.

Note: This post was initially machine‑translated, so I apologize if any part is difficult to read

2

I updated the documentation. Thanks for raising this problem and providing a fix. Note that you could have proposed a change request by editing the documentation page directly on xwiki.org

Thanks,
Marius

1 Like