Question Details | TechOverflow

Home

Community

Collections

Find Jobs

Popular Tags

John Smith

React 18: Hydration failed because the initial UI does not match what was rendered on the server

asked 2 months ago

1Answers

4Views

I'm trying to get SSR working in my app, but I get the error:

Hydration failed because the initial UI does not match what was rendered on the server.

Live demo code is here.

Live demo of problem is here (open dev tools console to see the errors):

File App.js

 import React from "react";

  class App extends React.Component {

  head() {
    return (
      <head>
        <meta charSet="utf-8" />
        <meta
          name="viewport"
          content="width=device-width, initial-scale=1, shrink-to-fit=no"
        />
        <meta name="theme-color" content="#000000" />
        <title>React App</title>
      </head>
    );
  }

  body() {
    return (
      <body>
        <div className="App">
          <h1>Client says Hello World</h1>
        </div>
      </body>
    );
  }

  render() {
    return (
      <React.Fragment>
        {this.head()}
        {this.body()}
      </React.Fragment>
    )
  }
}
export default App;

File index.js

import React from "react";
import * as ReactDOM from "react-dom/client";
import { StrictMode } from "react";

import App from "./App";


//const container = document.getElementById("root");
const container = document.getElementsByTagName("html")[0]

ReactDOM.hydrateRoot(
  container,
  <StrictMode>
    <App />
  </StrictMode>
);

The HTML template shown in the live demo is served by the backend and generated using the following code:

const ReactDOMServer = require('react-dom/server');

const clientHtml = ReactDOMServer.renderToString(
<StrictMode>
    <App />
</StrictMode>
)

// Serve clientHtml to client

I need to dynamically generate <head></head> and <body></body> section as shown in the App class.

reactjs

javascript

ssr

Write your answer here

1 Answers

Neo Anderson

answered 2 months ago

I have been experiencing the same problem lately with Next.js and I am not sure if my observations are applicable to other libraries.

I had been wrapping my components with an improper tag that is, Next.js is not comfortable having a p tag wrapping your divs, sections, etc., so it will yell "Hydration failed because the initial UI does not match what was rendered on the server".

I solved this problem by examining how my elements were wrapping each other. With material UI you would need to be cautious. For example, if you use a typography component as a wrapper, the default value of the component prop is "p", so you will experience the error if you don't change the component value to something semantic.

In my own opinion, based on my personal experience, the problem is caused by improper arrangement of HTML elements and to solve the problem in the context of Next.js, one will have to reevaluate how they are arranging their HTML element.