Por que a visualização de PDF falha em uma biblioteca de documentos

Ao abrir um PDF em uma biblioteca de documentos do SharePoint e ver uma página em branco, um prompt de download ou uma mensagem de erro, o recurso de visualização não está funcionando. Esse problema geralmente ocorre devido a configurações do navegador, falta de complementos de visualizador de PDF ou configuração do SharePoint que bloqueia o serviço de visualização. Este artigo explica as causas raiz das falhas de visualização de PDF e fornece correções passo a passo para restaurar a funcionalidade.

Por que a visualização de PDF falha em uma biblioteca de documentos

O SharePoint usa o serviço de visualização de PDF do Microsoft 365 para renderizar arquivos PDF diretamente no navegador. Quando esse serviço falha, o SharePoint recorre ao visualizador de PDF integrado do navegador ou solicita um download. A causa raiz geralmente é uma destas três coisas:

Visualizador de PDF do navegador desabilitado

Navegadores modernos como Google Chrome e Microsoft Edge têm um visualizador de PDF integrado. Se esse visualizador estiver desligado, o navegador não consegue exibir o PDF inline. Em vez disso, ele baixa o arquivo. A configuração é controlada por uma flag do navegador chamada “Baixar arquivos PDF em vez de abri-los automaticamente no Chrome” ou o equivalente no Edge.

Recurso de visualização de PDF do SharePoint desabilitado

Os administradores de locatário do SharePoint podem desabilitar o serviço de visualização de PDF no nível do locatário. Quando esse recurso está desligado, o SharePoint nunca envia o conteúdo do PDF para o serviço de visualização. Os usuários veem um botão de download ou um painel de visualização em branco.

Configuração da biblioteca força o download

Cada biblioteca de documentos tem uma configuração avançada chamada “Abrir documentos no navegador”. Se estiver definida como “Abrir no aplicativo cliente”, o SharePoint força o download de todos os arquivos em vez de abri-los no navegador. Isso substitui o serviço de visualização de PDF.

Etapas para restaurar a visualização de PDF em uma biblioteca de documentos

1. Verifique a configuração do visualizador de PDF do navegador no Chrome ou Edge
   Abra o Chrome ou Edge. Na barra de endereços, digite chrome://settings/content/pdfDocuments (Chrome) ou edge://settings/content/pdfDocuments (Edge). Certifique-se de que a alternância para “Baixar arquivos PDF em vez de abri-los automaticamente no Chrome” (ou Edge) esteja desativada. Se estiver ativada, desative-a e recarregue a biblioteca do SharePoint.
2. Ative o serviço de visualização de PDF na central de administração do SharePoint
   Vá para a central de administração do SharePoint. Selecione Configurações na navegação à esquerda. Na seção Visualização de PDF, certifique-se de que a alternância esteja Ativada. Se estiver desativada, ative-a e clique em Salvar. Aguarde até 15 minutos para a alteração se propagar.
3. Ajuste as configurações avançadas da biblioteca
   Navegue até a biblioteca de documentos onde a visualização de PDF falha. Clique no ícone de engrenagem e selecione Configurações da biblioteca. Em Configurações gerais, clique em Configurações avançadas. Na seção Abrir documentos no navegador, selecione Abrir no navegador. Clique em OK.
4. Limpe o cache e os cookies do navegador
   Pressione Ctrl + Shift + Delete para abrir a caixa de diálogo de limpeza de dados de navegação. Selecione Todo o período como intervalo de tempo. Marque Cookies e outros dados de sites e Imagens e arquivos em cache. Clique em Limpar dados. Recarregue o site do SharePoint.
5. Teste com um arquivo PDF diferente
   Carregue um novo arquivo PDF pequeno (menos de 10 MB) na biblioteca. Clique no arquivo para ver se a visualização carrega. Se o novo arquivo for visualizado corretamente, o PDF original pode estar corrompido ou ter recursos não suportados, como conteúdo 3D incorporado.

Se a visualização de PDF ainda falhar após a correção principal

Visualização de PDF mostra uma página em branco

Uma página em branco geralmente significa que o PDF é muito grande ou contém elementos complexos. O SharePoint tem um limite de tamanho de arquivo de 250 MB para visualização. Se o PDF for maior, ele não será visualizado. Além disso, PDFs com imagens digitalizadas, formulários ou fontes incorporadas podem falhar. Tente converter o PDF para um formato mais simples usando o Adobe Acrobat ou uma ferramenta online e faça o upload novamente.

Visualização de PDF mostra uma mensagem de erro

Mensagens de erro como “Este arquivo não pode ser visualizado” ou “Algo deu errado” geralmente indicam uma interrupção do serviço. Verifique o painel de integridade do serviço do Microsoft 365. Vá para a central de administração do Microsoft 365 > Integridade > Integridade do serviço. Procure por incidentes relacionados ao SharePoint ou Office Online. Se existir um incidente, aguarde a resolução pela Microsoft.

Visualização de PDF funciona em alguns sites, mas não em outros

Se a visualização funciona em um site do SharePoint, mas falha em outro, o problema provavelmente é um recurso de conjunto de sites ou um script personalizado. Verifique se o site tem uma página mestra personalizada ou JavaScript que bloqueia o iframe de visualização. Desative temporariamente scripts personalizados nas configurações do conjunto de sites: Configurações do site > Recursos do conjunto de sites > desative Script personalizado. Teste a visualização novamente.

Visualização de PDF falha apenas em dispositivos móveis ou tablets

Navegadores móveis geralmente têm suporte limitado a PDF. No iOS, o Safari usa o visualizador de PDF integrado da Apple. No Android, o Chrome usa seu próprio visualizador. Se a visualização falhar no celular, instale o aplicativo móvel do Microsoft 365. Abra a biblioteca de documentos no aplicativo e toque no PDF. O aplicativo usa o visualizador de PDF nativo do dispositivo.

Item	Visualizador de PDF do navegador	Serviço de visualização de PDF do SharePoint
Descrição	Visualizador integrado no Chrome, Edge, Firefox e Safari que renderiza PDFs inline	Serviço em nuvem do Microsoft 365 que gera uma visualização do conteúdo do PDF
Local de controle	chrome://settings/content/pdfDocuments ou edge://settings/content/pdfDocuments	Central de administração do SharePoint > Configurações > Visualização de PDF
Efeito quando desabilitado	O navegador baixa o PDF em vez de exibi-lo	O SharePoint mostra um botão de download ou painel de visualização em branco
Afeta todos os sites?	Sim, todos os sites no navegador	Sim, todos os sites no locatário
Requer administrador?	Não, o usuário pode alterar	Sim, o administrador do SharePoint deve ativar

Agora você pode diagnosticar e corrigir falhas de visualização de PDF em uma biblioteca de documentos do SharePoint. Comece verificando a configuração do visualizador de PDF do navegador e as configurações avançadas da biblioteca. Se o problema persistir, verifique se o serviço de visualização de PDF do SharePoint está ativado na central de administração. Como dica avançada, use o SharePoint Online Management Shell para verificar o status da visualização de PDF em todos os sites de uma vez com o cmdlet Get-SPOTenant e a propriedade DisablePDFPreview.