React Server Components: Quando Usar Server ou Client?
Você cria um componente novo no App Router do Next.js, usa useState dentro dele sem pensar duas vezes e a aplicação quebra com um erro apontando para um hook que, segundo o React, não pode rodar ali. O motivo é que, nesse modelo, todo componente nasce como um React Server Component por padrão, e você só descobre isso quando o build já falhou.
Server Components mudam uma decisão que antes nem existia: onde cada componente roda. Este artigo explica o que são, como decidir entre Server e Client Component, os erros mais comuns ao misturar os dois e o que isso muda na prática para o desempenho da aplicação.
O que são React Server Components
React Server Components são componentes React que renderizam inteiramente no servidor e nunca chegam ao navegador como código JavaScript. O HTML final desce pronto para o cliente, e nenhuma linha de lógica daquele componente entra no bundle que o usuário baixa.
Isso é diferente de Server Side Rendering tradicional. SSR também gera HTML no servidor, mas ainda envia o JavaScript do componente inteiro para o navegador fazer a hidratação depois. Um Server Component não hidrata, porque não existe nada para reidratar: ele não carrega estado de interface nem reage a evento depois que o HTML chega.
No App Router do Next.js, todo componente é Server Component por padrão. Para transformar um componente em Client Component, e só então ganhar acesso a useState, useEffect e a eventos de interface, é preciso declarar 'use client' na primeira linha do arquivo.
Server Component ou Client Component: como decidir
A pergunta certa não é qual dos dois é melhor, é o que aquele componente específico precisa fazer. Quatro perguntas resolvem a maioria dos casos:
- O componente guarda estado local, como um valor de input ou um contador? Então é Client Component.
- Ele reage a evento do usuário, como clique, scroll ou digitação? Então é Client Component.
- Ele usa alguma API exclusiva do navegador, como
localStorage, geolocalização ouwindow? Então é Client Component. - Ele só busca dado e devolve HTML, sem guardar nada e sem reagir a nada depois de montado? Fica Server Component, e deveria ficar: é ali que está o ganho.
Esse corte também aparece em como você pensa o estado da aplicação como um todo. Se o componente decide onde cada pedaço de informação vive, a lógica se aproxima bastante do que já detalhamos em Gerenciamento de Estado em React: Qual Abordagem Escolher?, só que agora a primeira pergunta deixou de ser "Context ou Zustand" e passou a ser "esse estado existe no servidor ou só depois que a página chegou no navegador".
Como migrar um componente de Client para Server Component
Migrar na direção certa, de Client para Server, segue uma sequência previsível:
- Separe o que busca dado do que reage a evento. Um componente que faz fetch e também controla um formulário está fazendo dois trabalhos. Divida em dois componentes antes de qualquer outra mudança.
- Remova o
'use client'do componente que só busca e renderiza. Sem a diretiva, ele volta a ser Server Component por padrão. - Troque
useEffectcom fetch porawaitdireto no corpo do componente. Server Component pode ser uma função assíncrona, então a busca de dado fica mais simples e sem estado de loading manual. - Passe o resultado como prop para o componente Client que ainda precisa de interação. O Server Component busca e entrega pronto, o Client Component só cuida da parte interativa.
- Rode o build e confira o relatório de bundle. O tamanho do JavaScript enviado ao navegador precisa cair depois da migração. Se não cair, algum import pesado ainda está vazando para o lado client.
Erros comuns ao misturar Server e Client Components
O erro mais frequente é colocar 'use client' no topo da árvore de componentes, normalmente no layout principal, para resolver um erro pontual sem investigar a causa. Isso transforma toda a árvore abaixo em Client Component, porque a diretiva se propaga para quem é importado por aquele arquivo, e anula o ganho que motivou usar Server Components.
Outro erro é passar uma função como prop de um Server Component para um Client Component esperando que ela rode no cliente. Funções não são serializáveis entre servidor e navegador, então o React rejeita essa passagem em tempo de build. O padrão correto é usar Server Actions quando o Client Component precisa disparar uma operação que roda no servidor.
Também é comum importar, dentro de um Client Component, algum módulo que só existe no lado servidor, como um cliente de banco de dados ou uma leitura de arquivo com o módulo fs. Esse tipo de import quebra o build porque aquele código precisaria existir no navegador, onde não há acesso a banco nem a sistema de arquivos.
Server Components e desempenho
O efeito mais direto de Server Components no desempenho é o tamanho do JavaScript que chega ao navegador. Menos componente convertido para Client significa menos código para baixar, parsear e executar antes da página responder à primeira interação.
Esse ganho aparece nas métricas de performance que já importam hoje. Detalhamos como cada uma é medida e otimizada em Core Web Vitals: Como Otimizar Cada Métrica, mas o resumo aqui é direto: um bundle menor chega mais rápido e deixa a thread principal livre mais rápido, o que ajuda tanto o LCP quanto o INP.
O ganho não é automático só por adotar o App Router. Ele depende de manter a fronteira entre Server e Client no lugar certo, componente por componente, em vez de empurrar a diretiva 'use client' para o topo da aplicação na primeira dificuldade.
Se o seu projeto em React ainda trata toda a árvore como Client Component por hábito, vale revisar onde cada parte realmente precisa rodar. Para discutir essa migração no seu caso específico, fale com a gente na página de contato.