Primeiro, salve o documento original e, em seguida, determine se a falha ocorre na conversão para PDF do ONLYOFFICE ou no download final do navegador. Se o editor reportar um erro de conversão, verifique os logs do Servidor de Documentos e confirme se o servidor consegue acessar o arquivo original. Se a conversão for bem-sucedida, mas o navegador exibir a mensagem "Download falhou", verifique o estado do download no navegador, as permissões do site e o espaço disponível em disco.
Cenário ilustrativo: Imagine que Jordan, um administrador que utiliza um editor ONLYOFFICE Docs auto-hospedado, seleciona Arquivo > Baixar como > PDF para um relatório de projeto. O editor exibe uma mensagem de erro e nenhum PDF é gerado. Este é um exemplo hipotético, não um incidente testado; o mesmo sintoma pode ocorrer em diferentes etapas, portanto, as verificações abaixo seguem o ponto em que o processo é interrompido.
Antes de solucionar problemas, use Salvar ou Ctrl+S para salvar as edições atuais. No Editor de Documentos online, o ONLYOFFICE documenta o caminho de exportação para PDF como Arquivo > Baixar como > PDF. O editor pode primeiro preparar o PDF e depois enviar o resultado para o navegador; portanto, uma falha no download pelo navegador nem sempre significa que a conversão em si falhou.
Use o mesmo relatório para fazer uma nova tentativa controlada. Observe se o editor exibe uma caixa de diálogo de erro, se o navegador cria uma entrada de download com falha e se o problema afeta apenas este arquivo ou todos os arquivos. Evite clicar repetidamente em Exportar: tarefas duplicadas dificultam a correspondência do registro de data e hora com a entrada de log do servidor correspondente.
Abra a página de Downloads do navegador e verifique o item com falha. Tente novamente. Verifique se o navegador bloqueou downloads do site da ONLYOFFICE, se há uma confirmação de download em outra aba e se a unidade de destino tem espaço livre suficiente. Se você gerencia o navegador, teste o mesmo documento salvo em um navegador alternativo ou em um perfil de navegador limpo. Se funcionar, concentre-se nas configurações do navegador, extensões ou software de segurança local; não altere a configuração do Servidor de Documentos ainda.
O caso hipotético de Jordan apontaria para o navegador quando o editor termina de preparar o PDF, mas a lista de downloads relata uma falha de rede ou de permissão. Uma alternativa prática é usar Arquivo > Imprimir e escolher a opção "Salvar como PDF" do navegador ou do sistema operacional, se disponível. Verifique as páginas, fontes e links resultantes, pois a saída de impressão pode ser diferente da exportação direta para PDF feita pelo editor. Essa solução alternativa não corrige um erro de conversão no servidor.
Para uma instalação auto-hospedada, peça a um administrador para inspecionar os logs do Servidor de Documentos no momento da nova tentativa. O ONLYOFFICE documenta os logs do Linux em ` /var/log/onlyoffice/documentserver/var/logs`; para o Docker, os logs estão disponíveis dentro do contêiner nesse caminho, e a saída do Docker também pode ser inspecionada com `docker logs` docker logs <container>. O componente exato e a redação do log dependem da instalação e da versão. Procure por erros de conversão, timeouts, falhas em requisições, códigos de status HTTP ou erros de DNS e conexão. Não publique linhas de log completas se elas contiverem URLs privadas, tokens de acesso, nomes de usuário ou nomes de documentos.
Quando os registros ou a API identificarem um problema no download da origem, verifique se o Servidor de Documentos consegue acessar a URL do documento de origem a partir do seu próprio espaço de nomes de rede. Um administrador pode testar a URL autorizada a partir do servidor ou contêiner e verificar o DNS, o roteamento, as regras de firewall, as configurações de proxy, os certificados TLS e a resposta do aplicativo de armazenamento. Uma URL que abre no navegador do seu computador pode ainda estar inacessível a partir do Servidor de Documentos. Por outro lado, se o download da origem for bem-sucedido, mas a conversão falhar, investigue o erro do conversor em vez de alterar o acesso à rede.
Para fluxos de trabalho de conversão baseados em API, use o código de erro retornado para identificar o problema. O ONLYOFFICE define erro de conversão -4como um erro ao baixar o arquivo de entrada, -2um tempo limite excedido, -3um erro de conversão e -8um token inválido. Esses códigos são específicos da resposta da API de conversão; a mensagem genérica "Download falhou" no editor não comprova, por si só, que uma conversão de PDF retornou um deles.
Se apenas os arquivos armazenados em uma plataforma conectada falharem, verifique o endereço do servidor de documentos do conector e as configurações de acesso interno. O serviço de edição deve conseguir recuperar o arquivo do seu sistema de armazenamento. A documentação de solução de problemas do ONLYOFFICE descreve a mensagem “Download falhou” durante o carregamento do editor como a impossibilidade do serviço de edição acessar o URL do arquivo. Essa orientação é útil quando o relatório não abre ou não carrega; se o editor abrir normalmente e apenas a exportação para PDF falhar, inspecione primeiro a etapa de exportação ou download.
Se a API reportar um token inválido, compare o segredo JWT, o cabeçalho e a configuração do token em ambas as extremidades. Não desative o JWT como atalho. Se a API indicar um limite de tamanho, compare o arquivo com os limites configurados em sua implantação. Um arquivo grande ou uma origem não suportada/corrompida pode exigir uma solução diferente; trocar de navegador ou de rede não resolverá um limite de conversão ou um documento corrompido.
Ative o registro de depuração somente se os registros comuns não mostrarem onde a solicitação é interrompida e desative-o após coletar as evidências necessárias. Os registros de depuração podem conter detalhes confidenciais da solicitação. Siga as instruções da ONLYOFFICE para o seu tipo de instalação e compartilhe um trecho do registro com as informações confidenciais ocultadas com seu administrador ou equipe de suporte, em vez de expor URLs ou tokens de documentos.
A documentação do ONLYOFFICE distingue as etapas de download de PDF dos erros de conversão. Consulte as instruções de download e impressão do Editor de Documentos , o guia oficial de solução de problemas de integração , os códigos de erro da API de conversão e o guia de registro de depuração para obter detalhes específicos da sua implementação.
Separe os problemas de download do navegador dos erros de conversão do lado do servidor e use o registro correto ou a verificação de acesso para que a exportação para PDF funcione.
Combine o segredo JWT usado pelo ONLYOFFICE Docs e Nextcloud, aplique-o com segurança em instalações Docker ou Linux e verifique a conexão sem enfraquecer a autenticação.
Instale o ONLYOFFICE Workspace Community no Ubuntu 24.04 com o script oficial do Docker, verifique os requisitos do servidor, ignore a instalação do Mail se necessário e verifique o portal com segurança.
Configure segredos JWT correspondentes para o ONLYOFFICE Docs e seu conector, com etapas seguras para pacotes Linux, implantações Docker e verificação.
Personalize o editor ONLYOFFICE Docs com o logotipo da sua empresa e as cores da interface, utilizando um arquivo de tema personalizado e uma configuração específica do editor. Consulte os limites de edição e as verificações de implantação.
Acompanhe as edições no Writer, preserve uma fonte ODT editável e verifique o arquivo DOCX exportado no Word antes de compartilhá-lo.
Siga o procedimento do SUSE SP7 para ativar o modo FIPS, reinicie com segurança, verifique a política ativa e confirme se o seu requisito de conformidade exige módulos validados.
Compare o YaST e o cryptsetup para um novo volume de dados SLES criptografado, escolha LUKS1 ou LUKS2 e verifique o comportamento de desbloqueio e montagem com segurança.
Configure o RMT no SLES 15, espelhe os repositórios autorizados e verifique o registro HTTPS e o acesso aos pacotes a partir de um cliente de teste.
Conecte o SLES 15 ao AD com o gerenciamento de logon baseado em SSSD do YaST e, em seguida, verifique a pesquisa de diretório, o login de domínio e os tickets Kerberos.
