新部署 SPA 后,代码拆分导致块无法加载

IT技术 reactjs webpack single-page-application webpack-2 create-react-app
2021-05-16 00:56:38

我有一个单页应用程序,我在每条路线上拆分代码。当我部署我的应用程序的新版本时,如果用户仍然打开页面并访问他们以前从未访问过的路线,则用户通常会收到错误消息。

另一种可能发生这种情况的情况是应用程序启用了 Service Worker。当用户在新部署后访问页面时,Service Worker 将从缓存中提供服务。然后,如果用户尝试访问不在其缓存中的页面,他们将遇到块加载失败。

目前我在我的应用程序中禁用了代码拆分以避免这种情况,但我一直很好奇处理这个问题的最佳方法是什么。我已经考虑过在用户完成加载初始页面后预加载所有其他路由,我相信这可能会解决路由上的代码拆分问题。但是假设我想对组件进行代码拆分,那么这意味着我必须尝试弄清楚何时以及如何预加载所有这些组件。

所以我想知道人们如何处理单页应用程序的这个问题?谢谢!(我目前正在使用 create-react-app)

4个回答

我更喜欢让用户刷新而不是自动刷新(这可以防止无限刷新循环错误的可能性)。
以下策略适用于 React 应用程序,路由上的代码拆分:

战略

  1. 将您的 index.html 设置为从不缓存。这可确保请求您的初始资产的主文件始终是最新的(通常它并不大,因此不缓存它应该不是问题)。请参阅MDN 缓存控制

  2. 对块使用一致的块散列。这确保只有更改的块才会具有不同的哈希值。(参见下面的 webpack.config.js 片段)

  3. 不要在部署时使 CDN 的缓存失效,这样旧版本在部署新版本时就不会丢失它的块。

  4. 在路由之间导航时检查应用程序版本,以便通知用户他们是否在旧版本上运行并请求他们刷新。

  5. 最后,以防万一 ChunkLoadError确实发生:添加一个错误边界。(参见下面的错误边界)

来自 webpack.config.js (Webpack v4) 的片段

来自Uday Hiwarale

optimization: {
  moduleIds: 'hashed',
  splitChunks: {
      cacheGroups: {
          default: false,
          vendors: false,
          // vendor chunk
          vendor: {
              name: 'vendor',
              // async + async chunks
              chunks: 'all',
              // import file path containing node_modules
              test: /node_modules/,
              priority: 20
          },
      }
  }

错误边界

错误边界的 React 文档

import React, { Component } from 'react'

export default class ErrorBoundary extends Component {
  constructor(props) {
    super(props);
    this.state = { hasError: false };
  }

  static getDerivedStateFromError(error) {
    // Update state so the next render will show the fallback UI.    
    return { hasError: true, error };
  }
  componentDidCatch(error, errorInfo) {
    // You can also log the error to an error reporting service    
    console.error('Error Boundary Caught:', error, errorInfo);
  }
render() {
    const {error, hasError} = this.state
    if (hasError) {
      // You can render any custom fallback UI      
      return <div>
      <div>
        {error.name === 'ChunkLoadError' ?
          <div>
            This application has been updated, please refresh your browser to see the latest content.
          </div>
          :
          <div>
            An error has occurred, please refresh and try again.
          </div>}
      </div>
      </div>
    }
    return this.props.children;
  }
}

注意:确保清除内部导航事件上的错误(例如,如果您正在使用 react-router),否则错误边界将在内部导航之后持续存在,并且只会在真正的导航或页面刷新时消失。

我们的 create-react-app 中的问题是脚本标记引用的块不存在,因此它在我们的 index.html 中抛出错误。这是我们得到的错误。

Uncaught SyntaxError: Unexpected token <    9.70df465.chunk.js:1 

更新

我们解决这个问题的方法是让我们的应用程序成为一个渐进式网络应用程序,这样我们就可以利用服务工作者。

将 create react 应用程序转换为 PWA 很容易。PWA 上的 CRA 文档

然后,为了确保用户始终使用最新版本的 service worker,我们确保每当有更新的 worker 等待时,我们都会告诉它 SKIP_WAITING,这意味着下次刷新浏览器时,他们将获得最新版本代码。

import { Component } from 'react';
import * as serviceWorker from './serviceWorker';

class ServiceWorkerProvider extends Component {
  componentDidMount() {
    serviceWorker.register({ onUpdate: this.onUpdate });
  }

  onUpdate = (registration) => {
    if (registration.waiting) {
      registration.waiting.postMessage({ type: 'SKIP_WAITING' });
    }
  }

  render() {
    return null;
  }
}

export default ServiceWorkerProvider;

Bellow 是我们尝试并确实遇到了一些无限循环的第一件事

我让它工作的方法是在 index.html 的所有脚本标签上方添加一个 window.onerror 函数。

<script>
  window.onerror = function (message, source, lineno, colno, error) {
    if (error && error.name === 'SyntaxError') {
      window.location.reload(true);
    }
  };
</script>

我希望有更好的方法,但这是我能想到的最好方法,并且感觉这是一个非常安全的解决方案,因为 create-react-app 不会编译或构建任何语法错误,这应该是我们唯一的情况得到一个语法错误。

我们用一个有点丑陋但非常简单的解决方案解决了这个问题。现在可能是暂时的,但可能会帮助某人。

我们创建了一个 AsyncComponent 来加载块(即路由组件)。当这个组件加载一个块并接收到错误时,我们只做一个简单的页面重新加载来更新 index.html 并且它是对主块的引用。它丑陋的原因是,根据页面的外观或加载方式,用户可能会在刷新前看到短暂的空白页面闪烁。这可能有点刺耳,但也许这也是因为我们不希望 SPA 自动刷新。

应用程序.js

// import the component for the route just like you would when
// doing async components
const ChunkedRoute = asyncComponent(() => import('components/ChunkedRoute'))

// use it in the route just like you normally would
<Route path="/async/loaded/route" component={ChunkedRoute} />

异步组件.js

import React, { Component } from 'react'

const asyncComponent = importComponent => {
  return class extends Component {
    state = {
      component: null,
    }

    componentDidMount() {
      importComponent()
        .then(cmp => {
          this.setState({ component: cmp.default })
        })
        .catch(() => {
          // if there was an error, just refresh the page
          window.location.reload(true)
        })
    }

    render() {
      const C = this.state.component
      return C ? <C {...this.props} /> : null
    }
  }
}

export default asyncComponent

我正在使用 AsyncComponent HOC 来延迟加载块,并且遇到了同样的问题。我所做的工作是识别错误并进行一次硬重新加载。

.catch(error => {
        if (error.toString().indexOf('ChunkLoadError') > -1) {
          console.log('[ChunkLoadError] Reloading due to error');
          window.location.reload(true);
        }
      });

完整的 HOC 文件如下所示,

export default class Async extends React.Component {
  componentWillMount = () => {
    this.cancelUpdate = false;
    this.props.load
      .then(c => {
        this.C = c;
        if (!this.cancelUpdate) {
          this.forceUpdate();
        }
      })
      .catch(error => {
        if (error.toString().indexOf('ChunkLoadError') > -1) {
          console.log('[ChunkLoadError] Reloading due to error');
          window.location.reload(true);
        }
      });
  };

  componentWillUnmount = () => {
    this.cancelUpdate = true;
  };

  render = () => {
    const props = this.props;
    return this.C ? (
      this.C.default ? (
        <this.C.default {...props} />
      ) : (
        <this.C {...props} />
      )
    ) : null;
  };
}