rochasolutions
Arquitetura

React Server Components: Quando Usar Server ou Client?

Danilo Rocha5 min de leitura

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 ou window? 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:

  1. 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.
  2. Remova o 'use client' do componente que só busca e renderiza. Sem a diretiva, ele volta a ser Server Component por padrão.
  3. Troque useEffect com fetch por await direto 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.
  4. 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.
  5. 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.