Safari não tocava músicas, mas o Chrome funcionava: investigando HEAD/Range em um proxy de áudio
Hoje corrigi no BotCF Music um problema de compatibilidade entre navegadores bem típico — e também bastante enganoso: o Chrome tocava as músicas, o Safari não. A página, as playlists e a busca funcionavam normalmente, e a resolução da URL da música também retornava resultado. Por isso, no início era muito fácil seguir pelo caminho de “a fonte de áudio está quebrada” ou “o evento de clique no front-end não disparou”. No fim, o verdadeiro problema não estava nos metadados da música nem no botão do player, mas nas diferenças entre os requisitos de contrato HTTP que cada navegador exige para o fluxo de áudio.
O sintoma era simples:
- No Chrome, clicar em reproduzir gerava som.
- No Safari, com a mesma música, a mesma página e a mesma interface, simplesmente parecia não tocar.
- A interface de busca e a resolução de
song_urlconseguiam retornar endereços de música válidos.
O ponto de virada foi mudar a pergunta de “o player chamou play?” para “que resposta o navegador recebeu de fato ao buscar o áudio?”. A pilha de mídia do Safari verifica recursos de áudio com mais rigor, especialmente se requisições HEAD e Range conseguem receber respostas adequadas. Ou seja, ele não precisa apenas de uma URL de MP3 que possa ser baixada no fim; ele também espera que o servidor responda como um servidor de mídia decente:
- Uma requisição
HEADdeve retornar o tipo de áudio, o tamanho e se há suporte a intervalos de bytes. Range: bytes=0-1deve retornar206 Partial Content.- A resposta deve incluir
Content-Range,Content-LengtheAccept-Ranges. - Em cenários cross-origin, a camada de JS/mídia precisa conseguir enxergar os cabeçalhos de resposta necessários.
O Chrome é relativamente mais flexível nesse tipo de cenário — ou, melhor dizendo, tem mais caminhos de tolerância a falhas. Então, ele conseguir tocar não significa que essa cadeia de áudio esteja correta segundo o padrão. O Safari não tocar, na verdade, era um alerta: esse proxy ainda não estava cumprindo por completo a semântica HTTP de um recurso de mídia.
A correção final desta vez foi concentrar a cadeia de reprodução em um proxy de áudio no mesmo domínio e completar o formato de resposta necessário para requisições de mídia:1. Adicionar tratamento de rota HEAD para /api/v1/freemusic/stream, /download e /audio-proxy.
2. stream não joga mais o frontend diretamente para a URL de áudio externa; em vez disso, redireciona para /api/v1/freemusic/audio-proxy no mesmo domínio.
3. audio-proxy repassa a solicitação Range enviada pelo navegador.
4. A resposta do proxy repassa content-type, content-length, content-range, accept-ranges, etag e last-modified.
5. No CORS, expor explicitamente content-disposition, content-length, content-range, accept-ranges.
6. A verificação de reprodução na etapa de análise também usa Range: bytes=0-1 para fazer uma checagem leve, evitando classificar por engano páginas de erro HTML/JSON como áudio.
Validação em produção após a correção, usando a mesma música kuwo/3195905 no music.botcf.com online:
song_url -> /api/v1/freemusic/audio-proxy?url=http%3A%2F%2Fcar-lv.kuwo.cn%2F...
HEAD /api/v1/freemusic/stream?... -> 302 -> 200
content-type: audio/mpeg
content-length: 10965357
accept-ranges: bytes
access-control-expose-headers: content-disposition, content-length, content-range, accept-ranges
GET /api/v1/freemusic/stream?... with Range: bytes=0-1 -> 302 -> 206
content-type: audio/mpeg
content-length: 2
content-range: bytes 0-1/10965357
Então, a explicação real para desta vez “o Safari tem problema, o Chrome não” não é nenhum mistério do Safari, mas sim que o Chrome temporariamente nos ajudou a contornar uma implementação incompleta do proxy de mídia. O Safari exige de forma mais rigorosa que o servidor ofereça suporte a HEAD e a requisições por intervalo de bytes, comuns na reprodução de mídia, e foi isso que acabou expondo o problema.
Uma experiência de troubleshooting bem útil: sempre que um <audio> / <video> “não reage” em determinado navegador, não olhe apenas se o JSON da API de negócio foi bem-sucedido, nem apenas se o botão foi acionado. Capture diretamente, na URL da mídia, o HEAD, o GET Range, o Content-Type, o Content-Range e o Accept-Ranges; isso acelera bastante a investigação.
O que mais confunde nesse tipo de problema é que a falha de reprodução acontece na pilha de mídia do navegador; o código do frontend pode não mostrar nenhuma exceção evidente, e o JSON do servidor também pode estar todo retornando 200. A prova real está naquele último fluxo de áudio.