withHashLocation is not compatible with SSR (throws TypeError: Invalid URL when parsing "#/")

[eblocha]

Which @angular/* package(s) are the source of the bug?

router

Is this a regression?

Yes

Description

When the withHashLocation feature is used under SSR, the build will hang after throwing an exception.

Please provide a link to a minimal reproduction of the bug

https://github.com/eblocha/ng-ssr-hash-routing

Please provide the exception or error you saw

ERROR TypeError: Invalid URL
    at new URL (node:internal/url:819:25)
    at HD (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:40:31721)
    at e.replaceState (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:40:32574)
    at e.replaceState (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:31:54829)
    at e.replaceState (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:31:52733)
    at e.setBrowserUrl (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:40:95885)
    at e.handleRouterEvent (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:40:95478)
    at Object.next (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:40:98624)
    at uf.next (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:4:3112)
    at ao._next (file:///Users/elliot.blocha/projects/scratch/ssr-test/.angular/prerender-root/fa99184b-c1cb-46ed-80af-134e4ceff1a7/main.server.mjs:4:2795) {
  code: 'ERR_INVALID_URL',
  input: '#/'

Please provide the environment you discovered this bug in (run ng version)

Angular CLI       : 21.2.7
Angular           : 21.2.9
Node.js           : 24.15.0
Package Manager   : npm 11.12.1
Operating System  : darwin arm64

┌───────────────────────────┬───────────────────┬───────────────────┐
│ Package                   │ Installed Version │ Requested Version │
├───────────────────────────┼───────────────────┼───────────────────┤
│ @angular/build            │ 21.2.7            │ ^21.2.7           │
│ @angular/cli              │ 21.2.7            │ ^21.2.7           │
│ @angular/common           │ 21.2.9            │ ^21.2.9           │
│ @angular/compiler         │ 21.2.9            │ ^21.2.9           │
│ @angular/compiler-cli     │ 21.2.9            │ ^21.2.9           │
│ @angular/core             │ 21.2.9            │ ^21.2.9           │
│ @angular/forms            │ 21.2.9            │ ^21.2.9           │
│ @angular/platform-browser │ 21.2.9            │ ^21.2.9           │
│ @angular/platform-server  │ 21.2.9            │ ^21.2.9           │
│ @angular/router           │ 21.2.9            │ ^21.2.9           │
│ @angular/ssr              │ 21.2.7            │ ^21.2.7           │
│ rxjs                      │ 7.8.2             │ ~7.8.0            │
│ typescript                │ 5.9.3             │ ~5.9.2            │
│ vitest                    │ 4.1.0             │ ^4.0.8            │
└───────────────────────────┴───────────────────┴───────────────────┘

Anything else?

No response

[SkyZeroZx]

I think this might be related to this latest fix #68194

A possible alternative would be to downgrade your version and perhaps apply the workaround mentioned here

Although the hash strategy is more commonly used when we have a SPA and don't want to configure the web server, if I recall correctly, on the other hand, you could configure your web server if possible.

[eblocha]

In my case, I am using Angular SSR to render Astro islands for a component library documentation site. The islands are small Angular apps to demo each component. Some of the demos use routing with hash-based locations so it doesn't change the url away from the current page.

I tested it with a traditional SSR app and hit the same exception. I can try to get a repro created soon.

[SkyZeroZx]

I can confirm this has been happening since the last fix in #68194.
Minimal repo: https://github.com/SkyZeroZx/hash-error ( Using angular next )
I tested it with Angular 21.2.0 and the build worked correctly.

[martyganz]

Getting the same error without withHashLocation on and going to homepage with query parameters. This is happening during development but also happening on fully compiled/build version of the application.

error: TypeError: Invalid URL
    at new URL (node:internal/url:819:25)
    at parseUrl (vite/deps_ssr/chunk-DB33TPUV.js:421:10)
    at _ServerPlatformLocation.replaceState (vite/deps_ssr/chunk-DB33TPUV.js:494:9)
    at _BaseHrefPathLocationStrategy.replaceState (vite/deps_ssr/chunk-KVDH5UHP.js:151:28)
    at _Location.replaceState (vite/deps_ssr/chunk-KVDH5UHP.js:299:28)
    at _HistoryStateManager.setBrowserUrl (vite/deps_ssr/chunk-NDFFTJPQ.js:4146:21)
    at _HistoryStateManager.handleRouterEvent (vite/deps_ssr/chunk-NDFFTJPQ.js:4124:14)
    at Object.eval (vite/deps_ssr/chunk-NDFFTJPQ.js:4277:29)
    at ConsumerObserver2.ConsumerObserver2.next (vite/deps_ssr/chunk-DRSLY4WJ.js:530:29)
    at SafeSubscriber2.Subscriber2._next (vite/deps_ssr/chunk-DRSLY4WJ.js:499:26) {
  code: 'ERR_INVALID_URL',
  input: '?foo=bar'
}

Angular CLI       : 21.2.7
Angular           : 21.2.9
Node.js           : 24.14.0
Package Manager   : yarn 1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447
Operating System  : darwin arm64

┌───────────────────────────────────┬───────────────────┬───────────────────┐
│ Package                           │ Installed Version │ Requested Version │
├───────────────────────────────────┼───────────────────┼───────────────────┤
│ @angular-devkit/architect         │ 0.2102.7          │ 0.2102.7          │
│ @angular-devkit/build-angular     │ 21.2.7            │ 21.2.7            │
│ @angular-devkit/core              │ 21.2.7            │ 21.2.7            │
│ @angular-devkit/schematics        │ 21.2.7            │ 21.2.7            │
│ @angular-devkit/schematics-cli    │ 21.2.7            │ 21.2.7            │
│ @angular/animations               │ 21.2.9            │ 21.2.9            │
│ @angular/build                    │ 21.2.7            │ 21.2.7            │
│ @angular/cdk                      │ 21.2.7            │ 21.2.7            │
│ @angular/cli                      │ 21.2.7            │ 21.2.7            │
│ @angular/common                   │ 21.2.9            │ 21.2.9            │
│ @angular/compiler                 │ 21.2.9            │ 21.2.9            │
│ @angular/compiler-cli             │ 21.2.9            │ 21.2.9            │
│ @angular/core                     │ 21.2.9            │ 21.2.9            │
│ @angular/forms                    │ 21.2.9            │ 21.2.9            │
│ @angular/language-service         │ 21.2.9            │ 21.2.9            │
│ @angular/material                 │ 21.2.7            │ 21.2.7            │
│ @angular/platform-browser         │ 21.2.9            │ 21.2.9            │
│ @angular/platform-browser-dynamic │ 21.2.9            │ 21.2.9            │
│ @angular/platform-server          │ 21.2.9            │ 21.2.9            │
│ @angular/router                   │ 21.2.9            │ 21.2.9            │
│ @angular/ssr                      │ 21.2.7            │ 21.2.7            │
│ @angular/youtube-player           │ 21.2.7            │ 21.2.7            │
│ @schematics/angular               │ 21.1.5            │ 21.1.5            │
│ ng-packagr                        │ 21.1.0            │ 21.1.0            │
│ rxjs                              │ 7.8.2             │ 7.8.2             │
│ typescript                        │ 5.9.2             │ 5.9.2             │
│ vitest                            │ 4.1.2             │ 4.1.2             │
│ zone.js                           │ 0.16.1            │ 0.16.1            │```