Um componente de servidor é uma parte da interface React que executa apenas no servidor. O código dele não é enviado ao navegador. O servidor prepara o resultado e o entrega junto da resposta, e a interface aparece sem carregar aquela implementação no cliente.
No App Router do Next.js, páginas e layouts são componentes de servidor por padrão. A diretiva use client marca a entrada de uma parte que precisa executar no navegador. A divisão acompanha o comportamento da tela, não o tamanho do arquivo.
O que o componente pode fazer
Um componente de servidor pode ser assíncrono e consultar uma API ou um banco antes de montar a interface. Ele não usa estado, efeitos ou APIs do navegador. O código da consulta fica no servidor, o que evita enviar credenciais ao cliente.
O exemplo abaixo prepara uma lista de produtos no servidor:
export default async function Catalogo() { const produtos = await listarProdutos()
return ( <ul> {produtos.map((produto) => ( <li key={produto.id}>{produto.nome}</li> ))} </ul> )}O navegador recebe a lista renderizada. A função listarProdutos e a credencial usada por ela permanecem no servidor. O resultado, porém, faz parte da resposta: os nomes enviados ficam visíveis para os visitantes que abrirem a página.
Onde entra o componente cliente
Um seletor de quantidade, um botão de favoritos ou um campo com validação instantânea precisam de estado e eventos. Esses trechos recebem a diretiva use client e também integram o JavaScript do navegador. O componente de servidor entrega as informações iniciais por propriedades.
'use client'
import { useState } from 'react'
export function Quantidade({ inicial }) { const [valor, setValor] = useState(inicial)
return ( <button onClick={() => setValor(valor + 1)}> {valor} </button> )}As propriedades enviadas precisam ser serializáveis. Um objeto de conexão com o banco, uma função interna ou uma instância de biblioteca não atravessa esse limite. O componente de servidor seleciona os campos que a parte interativa precisa e monta um objeto simples.
A diretiva no lugar certo
A diretiva use client marca um módulo e os módulos que ele importa. Colocá-la no topo de um layout envia ao navegador código em quantidade acima do necessário. Um botão isolado costuma ser suficiente para concentrar a interatividade.
A composição com children permite manter a consulta no servidor e a moldura interativa no cliente. O servidor prepara o conteúdo, e o componente cliente define onde ele aparece. Essa divisão reduz o JavaScript sem tirar a interação.
Segurança não é automática
O fato de o código executar no servidor não libera a leitura de qualquer registro. A consulta precisa conferir se a sessão pode acessar aquela fatura ou aquele perfil. A separação de ambientes protege a implementação, e a autorização protege a informação.
A resposta também precisa ser seletiva. Um componente que devolve o registro inteiro pode expor campos internos que a tela não mostra. Ocultar com CSS não remove o valor do HTML. A seleção das colunas acompanha o que a interface realmente precisa.
Relação com a renderização
A renderização define o momento de preparação da resposta, com renderização sob demanda, cache ou geração prévia. O componente de servidor define onde o código executa. São duas dimensões diferentes, e a rota escolhe a combinação conforme o framework.
No Next.js, a primeira visita pode gerar HTML no servidor e depois hidratar as partes interativas. O componente de servidor não participa dessa hidratação, porque a implementação dele não chegou ao navegador.
Dúvidas frequentes
Perguntas frequentes sobre Componente de servidor
- Componente de servidor é a mesma coisa que renderização no servidor?
- Não. A renderização no servidor produz o HTML da página. O componente de servidor define um tipo de componente que executa apenas no servidor e não integra o JavaScript enviado ao navegador. Os dois conceitos se combinam no Next.js.
- Posso usar useState num componente de servidor?
- Não. Estado, efeitos e APIs do navegador pertencem ao componente cliente. Quando a interface precisa de interação, uma parte marcada com use client assume esse trecho e recebe as informações por propriedades.
- O código do componente de servidor pode conter segredo?
- A implementação não vai para o navegador, mas os valores enviados como propriedades e o conteúdo renderizado fazem parte da resposta. Credenciais ficam no servidor; a seleção dos campos e a autorização da consulta continuam necessárias.
Para continuar
Recursos relacionados
Documentação
React: componentes de servidor
Define o que um componente de servidor pode executar e como ele se diferencia de um componente cliente.
Abrir recursoDocumentação
Next.js: Server e Client Components
Mostra o padrão do App Router, a diretiva use client e a composição entre as duas partes da interface.
Abrir recursoSite de referência
Promovaweb: Server Components no Next.js
Aplica a divisão numa página de catálogo, com consulta no servidor e controles interativos no cliente.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar uma aplicação no App Router, você separa o que consulta o banco no servidor do que precisa de estado e eventos no navegador.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.