Se o ONLYOFFICE exibir a mensagem “Download falhou” após você exportar um documento como PDF, primeiro descubra qual etapa falhou: a geração do PDF, a transferência do ONLYOFFICE para o seu dispositivo ou o salvamento final pelo navegador. Uma exportação bem-sucedida deve gerar um PDF não vazio que abra e mantenha as quebras de página, tabelas e fontes importantes. Tente as verificações abaixo na ordem indicada; cada uma delas ajuda a identificar a causa do problema sem alterar o documento original.
Comece identificando a sua versão do ONLYOFFICE.
No Editor de Documentos online, o caminho documentado é Arquivo > Baixar como > PDF . “Salvar cópia como” salva uma cópia no portal em vez de baixá-la para o seu computador. Nos Editores para Desktop, use Arquivo > Salvar como e selecione PDF. Os rótulos e as opções disponíveis variam entre os aplicativos e versões, portanto, não presuma que um menu online esteja presente no aplicativo para desktop. Consulte as instruções de download e impressão de documentos do ONLYOFFICE e o guia da guia Arquivo .
Se você estiver editando um PDF existente no editor de PDF online, o processo de download também está em Arquivo, mas trata-se de um editor diferente. Siga as instruções do aplicativo que você está usando.
1. Proteja suas edições antes de solucionar problemas.
Antes de repetir uma exportação, salve o documento de origem. No editor online, use Ctrl+S ou Arquivo > Salvar, se disponível, e aguarde a confirmação de salvamento. O ONLYOFFICE salva automaticamente os documentos no editor online, mas você ainda deve confirmar se as alterações atuais foram salvas antes de atualizar ou fechar a sessão. Nos editores de desktop, salve o arquivo de trabalho normalmente primeiro.
Em seguida, faça uma cópia do documento e tente exportá-lo a partir dessa cópia. Isso permite um teste seguro sem arriscar o original. Evite clicar repetidamente em "Exportar" enquanto uma solicitação ainda estiver em andamento; downloads simultâneos podem dificultar a identificação de qual arquivo foi exportado com sucesso.
2. Utilize um pequeno documento de teste para isolar a falha.
Crie um novo documento de uma página com uma pequena linha de texto e exporte-o como PDF usando o mesmo aplicativo e dispositivo. Verifique se o PDF aparece na lista de downloads do navegador ou na pasta selecionada na caixa de diálogo de salvar do computador e confirme se o tamanho do arquivo é maior que zero. Abra-o em um visualizador de PDF e certifique-se de que o texto esteja visível.
- O PDF de teste funciona: o caminho de exportação está disponível. O arquivo original pode conter conteúdo ou formatação que cause um problema de conversão, ou seu download pode ser excepcionalmente grande ou lento. Continue com uma cópia do original e simplifique temporariamente imagens pesadas, objetos incorporados ou layouts complexos, uma categoria por vez.
- O PDF de teste também falha no editor online: verifique os downloads do navegador e tente a rota alternativa abaixo. Se o problema persistir em diferentes navegadores ou usuários, o serviço online ou sua integração podem precisar de atenção.
- O PDF de teste funciona em editores de desktop, mas não online: o problema provavelmente está mais relacionado ao navegador, à sessão online, ao portal ou à conexão com o servidor de documentos do que à exportação de PDF em geral.
Essa comparação é uma pista diagnóstica, não uma prova definitiva da causa raiz. Monitore o aplicativo, o navegador, o horário, o tamanho do documento e se a falha afeta um arquivo ou todos os arquivos.
3. Geração de PDF separada do download do navegador
No editor online, selecione Arquivo > Baixar como > PDF uma vez e, em seguida, verifique o painel de downloads do navegador. Se um arquivo estiver listado, use a opção "Mostrar na pasta" ou equivalente do navegador e verifique o tamanho. Um arquivo que abre corretamente significa que a geração do PDF foi bem-sucedida; o problema restante pode estar relacionado a onde o navegador salvou o arquivo ou como o navegador lidou com o download.
Se o download for bloqueado, interrompido ou não for concluído, verifique as notificações de download do navegador e o espaço disponível em disco do sistema operacional. Se o seu navegador ou organização bloquear downloads do site, pergunte ao administrador se o site tem permissão para baixar arquivos. Para um teste único, use outro navegador compatível no mesmo dispositivo ou em outro dispositivo com a mesma conta. Se funcionar, concentre-se nas configurações de download, extensões, software de segurança ou armazenamento local do primeiro navegador, em vez de alterar o documento.
A navegação privada pode ajudar a determinar se uma extensão ou dados armazenados do site estão envolvidos, mas somente se você conseguir fazer login e abrir o mesmo documento lá. Ela não corrige uma falha de exportação no servidor e pode não ser apropriada para contas gerenciadas. Não limpe todos os dados do navegador como primeiro passo; isso pode desconectá-lo de serviços não relacionados.
4. Experimente uma rota alternativa e compare o resultado.
Para um documento no Editor de Documentos online, tente Arquivo > Salvar cópia como e escolha PDF, se esse formato estiver disponível. Isso salva uma cópia no portal; não testa o mesmo caminho de download do navegador para o computador. Se a cópia do portal abrir, é provável que a exportação tenha gerado um PDF e o caminho de download direto seja a questão principal.
Você também pode tentar imprimir em PDF como uma solução temporária. O ONLYOFFICE documenta uma opção de impressão e observa que o Firefox pode imprimir sem baixar o PDF primeiro. Escolha um destino para o PDF na caixa de diálogo de impressão, se o seu navegador ou sistema operacional oferecer essa opção. Em editores de desktop, use a opção de PDF da caixa de diálogo de impressão, se disponível. Compare a contagem de páginas, as quebras de página e qualquer conteúdo próximo às margens com o original.
A opção Imprimir para PDF não é idêntica à exportação. Ela pode aplicar configurações de layout de impressão e alterar o dimensionamento da página ou omitir conteúdo fora da área imprimível. Use-a somente quando o arquivo resultante passar por suas próprias verificações visuais, especialmente para formulários, planilhas ou documentos com paginação precisa.
5. Se você usa editores de desktop, salve em um caminho local simples.
Nos editores de desktop, escolha Arquivo > Salvar como, selecione PDF e salve uma cópia em uma pasta na qual você tenha permissão de escrita, como a pasta Documentos. Dê um nome curto ao arquivo usando letras e números comuns. Não salve diretamente em um compartilhamento de rede, pasta sincronizada, unidade removível ou diretório de sistema protegido durante o primeiro teste. Se a cópia local funcionar, tente novamente no destino desejado; essa comparação indica um problema de destino ou de permissão.
Se a caixa de diálogo de salvamento for concluída, mas nenhum PDF utilizável for exibido, verifique se a pasta tem permissão de escrita e espaço livre. Feche qualquer visualizador de PDF que possa estar bloqueando o arquivo de destino, escolha um novo nome de arquivo e tente novamente. Se apenas um documento de origem falhar, enquanto um teste básico for bem-sucedido, faça uma cópia de trabalho e teste após remover ou substituir mídias excepcionalmente grandes ou danificadas. Mantenha o original intacto até verificar a cópia.
6. Quando um administrador deve inspecionar o servidor
Se todos os usuários observarem a falha no editor online, ou se tanto o download direto quanto a cópia pelo portal falharem, forneça ao administrador do ONLYOFFICE o horário da tentativa, o tamanho aproximado do documento afetado, o navegador e a versão utilizados e se um pequeno documento de teste também apresentou falha. Para uma instalação integrada ou auto-hospedada, o administrador deve verificar os logs do Servidor de Documentos e da plataforma em torno desse horário, confirmar se o editor e a plataforma de armazenamento conseguem se comunicar e revisar as alterações recentes de proxy ou rede.
A documentação de solução de problemas do ONLYOFFICE mapeia certos erros do editor para tokens de segurança expirados, sessões interrompidas ou erros de salvamento e aconselha os administradores a verificarem os logs do DocService e a disponibilidade do callback para falhas de salvamento. Essas mensagens são diagnósticos relacionados e não uma explicação universal para todos os alertas de "Download Falhou". Se a instância estiver atrás de um proxy reverso, verifique os cabeçalhos de host e protocolo encaminhados em relação ao guia de configuração de proxy atual do ONLYOFFICE . Os administradores podem seguir as instruções de registro de depuração do ONLYOFFICE para coletar mais detalhes e, em seguida, retornar o registro ao seu nível normal após o diagnóstico.
Não altere os segredos JWT, não desative a autenticação nem exponha o Servidor de Documentos publicamente para fins de teste. Essas alterações podem gerar problemas de segurança e integração, além de deixar a falha de exportação sem solução.
Como confirmar se o problema foi resolvido
Exporte um pequeno documento de teste e, em seguida, a cópia de trabalho do original. Confirme se cada PDF tem um tamanho diferente de zero, abre sem erros, possui a quantidade de páginas esperada e preserva textos importantes, tabelas, imagens e quebras de página. Se você usou "Salvar cópia como" ou "Imprimir para PDF", verifique se o arquivo está no portal ou pasta local desejada e compare seu layout com o da exportação normal. Quando apenas um dos métodos funcionar, registre essa diferença para o administrador; isso indica a etapa que ainda precisa ser investigada.
Referências oficiais