M3U8 Playback Troubleshooting Checklist

この記事は中文と英語で提供されています。日本語訳は準備中です。

When an M3U8 won't play, don't retry blindly. Work through the list below — it's the fastest route to the cause.

1. Is the link still valid?

Open the URL in a browser and see if you get text beginning with #EXTM3U. A 404 or an error page means the link is dead.

2. Cross-check with a desktop player

Open the same address in VLC. If VLC plays it and the web page doesn't, it's almost certainly CORS. If neither plays, the source itself is likely broken.

3. Check CORS

Look for CORS errors in the browser console. If present, the source server hasn't allowed your domain — switch sources, configure a proxy, or use a desktop player.

4. Check codec compatibility

Some browsers don't support certain codecs (HEVC or AV1 on specific platforms). Sticking to H.264 video and AAC audio is usually safest.

5. Check encryption

If the playlist contains #EXT-X-KEY, a failed key fetch will also stop playback. DRM content only works in supporting clients.

Write down the result of each step — it usually pins down the faulty link quickly. Most "weird" failures end up being a dead link or a CORS problem.
← Record an HLS Live Stream: Turn Live into ReplayableImproving HLS Playback from the Production Side →