docusaurus serve crashes if filename contains non ASCII-Characters

[fmabap]

Have you read the Contributing Guidelines on issues?

• I have read the Contributing Guidelines on issues.

Prerequisites

• I'm using the latest version of Docusaurus.
• I have tried the npm run clear or yarn clear command.
• I have tried rm -rf node_modules yarn.lock package-lock.json and re-installing packages.
• I have tried creating a repro with https://new.docusaurus.io.
• I have read the console error message carefully (if applicable).

Description

Hi,

I have a markdown page that conatins an image. The filename of the image contains german special characters (umlauts) like äöü. When I open the page then the server crashes.

Maybe this is related to the issue #8124

Please find the details below.

Can you please fix it?

Best regards
Frank

Reproducible demo

No response

Steps to reproduce

Create a markdown page that links to an existing image with filename image_äöü.png
Here is an example:

# Test 123

![test](image_äöü.png)

run
npm run build
npm run serve

Click on the page in the browser

Expected behavior

The image will be shown.

Actual behavior

The page is shown, without the image and the server crashes with the following error:

Your environment

• Docusaurus version used: 3.6.1
• Environment name and version ( Chrome 130, Node.js v22.11.0):
• Operating system and version (e.g. Windows 11):

Self-service

• I'd be willing to fix this bug myself.

[slorber]

This is a bug in docusaurus serve, and shouldn't happen if you host Docusaurus on a CDN.

I've also seen something similar when working on our visual regressions tests (#10650) where I had to skip those 2 problematic URLs:

    '/tests/docs/tests/ascii/%C3%A6%C3%B8%C3%A5',
    '/tests/docs/tests/ascii/folder/%C3%A6%C3%B8%C3%A5',

---

Most likely this is a bug in our serve-handler dependency. But I'm not sure it's going to be fixed anytime soon 😅

We haven't changed this code much lately, but there was a serve-handler release, maybe it broken something?

https://github.com/vercel/serve-handler/releases/tag/6.1.6

Looks related: vercel/serve-handler#205

[fmabap]

Thank you!

I installed in the meantime http-server. This seams to work as alternative.