Falha na Pré-visualização de PDF em Biblioteca de Documentos: Causa e Solução

Ao abrir um arquivo PDF em uma biblioteca de documentos do SharePoint, o navegador deve exibir um painel de visualização ou um visualizador inline. Em vez disso, você vê um prompt de download, uma página em branco ou uma mensagem de erro informando que o arquivo não pode ser visualizado. Esse problema ocorre porque o serviço de renderização de PDF do SharePoint é bloqueado por configurações do navegador, extensões ausentes ou recursos desabilitados do SharePoint. Este artigo explica a causa raiz técnica das falhas de visualização de PDF e fornece correções passo a passo para restaurar a experiência de visualização inline.

Por que a Pré-visualização de PDF Falha em Bibliotecas de Documentos do SharePoint

O SharePoint usa um mecanismo de renderização de PDF integrado para converter páginas de PDF em imagens para o painel de visualização. Esse mecanismo depende do navegador para enviar o arquivo ao serviço de renderização do SharePoint sem baixá-lo. Quando o navegador intercepta a solicitação de PDF e tenta abri-lo usando seu próprio visualizador de PDF, a visualização falha. A causa raiz é um conflito entre o tratamento padrão de PDF do navegador e o pipeline de renderização do SharePoint.

Três fatores técnicos comuns causam esse conflito:

Configurações de PDF do Navegador Sobrepõem o SharePoint

Navegadores modernos como Microsoft Edge, Google Chrome e Mozilla Firefox incluem um visualizador de PDF integrado. Quando configurado para “Sempre baixar arquivos PDF” ou “Abrir no navegador”, o navegador assume o controle do arquivo antes que o SharePoint possa renderizá-lo. O navegador baixa o arquivo ou o abre em uma guia separada, ignorando completamente o painel de visualização do SharePoint.

Extensão do Visualizador de PDF do SharePoint Ausente ou Desabilitada

A Microsoft fornece uma extensão de navegador chamada “Microsoft SharePoint PDF Viewer” para Chrome e Edge. Essa extensão instrui o navegador a entregar arquivos PDF ao SharePoint para renderização, em vez de usar o visualizador nativo do navegador. Se a extensão estiver ausente, desabilitada ou bloqueada por política de grupo, o SharePoint não pode solicitar o arquivo para visualização.

Configuração de Visualização de PDF no Nível do Tenant Desabilitada

Os administradores do SharePoint podem desabilitar a visualização de PDF no nível do tenant. Quando desabilitada, o sistema trata arquivos PDF como qualquer outro documento não visualizável e força o download. Essa configuração substitui qualquer configuração do navegador ou extensão.

Passos para Restaurar a Pré-visualização de PDF no SharePoint

Siga estes passos em ordem. Teste a visualização de PDF após cada etapa para identificar a causa exata.

Passo 1: Alterar Configurações de PDF do Navegador

1. Abra as configurações de PDF do navegador
   No Microsoft Edge, vá para edge://settings/content/pdfDocuments. No Google Chrome, vá para chrome://settings/content/pdfDocuments. No Firefox, vá para about:preferences#general e encontre a seção Aplicativos.
2. Desabilite “Sempre baixar arquivos PDF”
   No Edge e Chrome, desative a opção “Sempre baixar arquivos PDF”. No Firefox, altere a ação para PDF de “Salvar arquivo” para “Visualizar no Firefox” ou “Usar Adobe Acrobat (se instalado)”.
3. Reinicie o navegador
   Feche todas as janelas do navegador e reabra-as. Navegue até a biblioteca de documentos do SharePoint e clique em um arquivo PDF.

Passo 2: Instalar ou Habilitar a Extensão do Visualizador de PDF do SharePoint

1. Abra a loja de extensões do navegador
   No Edge, vá para a loja de complementos do Edge. No Chrome, vá para a Chrome Web Store. Pesquise por “Microsoft SharePoint PDF Viewer”.
2. Instale a extensão
   Clique em “Obter” ou “Adicionar ao Chrome”. Confirme a instalação quando solicitado.
3. Habilite a extensão
   Após a instalação, clique no ícone de quebra-cabeça na barra de ferramentas do navegador. Encontre “Microsoft SharePoint PDF Viewer” e certifique-se de que o pino está visível. Clique com o botão direito na extensão e selecione “Gerenciar extensão”. Ative a opção “Permitir acesso a URLs de arquivo”.
4. Atualize a página do SharePoint
   Recarregue a biblioteca de documentos e teste a visualização de PDF.

Passo 3: Verificar a Configuração de Visualização de PDF no Nível do Tenant

1. Abra o centro de administração do SharePoint
   Faça login no centro de administração do Microsoft 365 como administrador do SharePoint. Selecione “SharePoint” no menu do centro de administração.
2. Vá para Configurações
   Na navegação à esquerda, selecione “Configurações”. Role para baixo até a seção “Visualização de PDF”.
3. Habilite a visualização de PDF
   Certifique-se de que a opção “Permitir visualização de PDF” esteja ativada. Se estiver desativada, ative-a e clique em “Salvar”.
4. Aguarde a propagação
   As alterações podem levar até 30 minutos para serem aplicadas em todos os sites. Após aguardar, teste a visualização de PDF novamente.

Se a Pré-visualização de PDF Ainda Falhar Após a Correção Principal

Se a visualização ainda não aparecer, verifique estes problemas adicionais.

Arquivo PDF Muito Grande ou Corrompido

O mecanismo de visualização de PDF do SharePoint tem um limite de tamanho de arquivo de 10 MB. Arquivos maiores que 10 MB não serão renderizados no painel de visualização. Além disso, um arquivo PDF corrompido pode fazer o serviço de renderização falhar. Tente enviar um PDF menor e conhecido como bom para testar.

Extensões do Navegador em Conflito com o SharePoint

Outras extensões, como bloqueadores de anúncios, ferramentas de privacidade ou editores de PDF, podem interferir na solicitação do SharePoint para renderizar o arquivo. Desative temporariamente todas as outras extensões e teste a visualização. Se funcionar, reative as extensões uma por uma para encontrar a conflitante.

Recurso “Renderização de PDF” do SharePoint Desabilitado no Nível do Site

Os administradores de coleção de sites podem desabilitar o recurso de renderização de PDF para um site específico. Vá para Configurações do Site > Recursos da Coleção de Sites. Verifique se “Renderização de PDF” está definido como Ativo. Se estiver Inativo, clique em “Ativar”.

Pré-visualização de PDF no SharePoint: Navegador vs Extensão vs Configuração do Tenant

Item	Configuração de PDF do Navegador	Extensão do Visualizador de PDF do SharePoint	Configuração de Visualização de PDF do Tenant
Descrição	Controla se o navegador baixa ou exibe arquivos PDF	Força o navegador a enviar arquivos PDF para o SharePoint para renderização	Habilita ou desabilita o recurso de visualização de PDF para todos os sites do tenant
Onde configurar	Página de configurações do navegador (edge://settings/content/pdfDocuments)	Chrome Web Store ou loja de complementos do Edge	Centro de administração do SharePoint > Configurações > Visualização de PDF
Efeito quando desabilitado	Navegador baixa o PDF em vez de visualizar	SharePoint não pode solicitar o arquivo; navegador usa seu próprio visualizador	Todos os arquivos PDF são tratados como documentos não visualizáveis
Ação de correção	Desative “Sempre baixar arquivos PDF”	Instale e habilite a extensão; permita acesso a URLs de arquivo	Ative “Permitir visualização de PDF”

Essas três configurações trabalham juntas. O navegador deve entregar o arquivo ao SharePoint, a extensão deve estar presente e o tenant deve permitir visualizações. Um problema em qualquer uma delas quebra a visualização.

Conclusão

Agora você pode identificar por que a pré-visualização de PDF falha em uma biblioteca de documentos do SharePoint e aplicar a correção correta. Comece verificando a configuração de PDF do navegador, depois instale a extensão do Visualizador de PDF do SharePoint e, finalmente, verifique a configuração de visualização de PDF no nível do tenant. Se o problema persistir, teste com um arquivo menor e desative extensões conflitantes do navegador. Para confiabilidade contínua, defina uma política de grupo no Edge ou Chrome para forçar a ativação da extensão do Visualizador de PDF do SharePoint para todos os usuários da sua organização.