As explained under #35404 it would help to show an example of inserting a path prefix with a placeholder for the version. It's not immediately obvious that a placeholder is needed.

I really had issues with the path seqment strategy, because the hint

Note

When using a path segment, consider configuring a shared path prefix externally in Path Matching options.

was not clear for me. A sample would be really nice here to clarify that this is recommended to add a {version} placeholder. Before getting this, I tried samples without any placeholder, because I thought this path segment would be added automatically to the routing. The second try was to add the placeholder to the @RequestMapping in the controller, which worked for me, but was not a good solution.