Next.js項(xiàng)目實(shí)戰(zhàn)踩坑指南

用戶83 發(fā)布于2019-08-23 13:46 / 1992人閱讀

摘要：項(xiàng)目實(shí)戰(zhàn)踩坑指南移動(dòng)端，滾動(dòng)卡頓解決方案主容器增加樣式路由跳轉(zhuǎn)后樣式丟失原因下樣式根據(jù)頁面動(dòng)態(tài)加載，瀏覽器緩存文件造成樣式不更新。跨域及傳遞的問題第一步，登錄成功后服務(wù)器返回。第二步，瀏覽器自動(dòng)緩存，再后續(xù)請(qǐng)求中攜帶此。

項(xiàng)目實(shí)戰(zhàn)踩坑指南 1. 移動(dòng)端overflow:auto，ios滾動(dòng)卡頓

解決方案：主容器增加樣式-webkit-overflow-scrolling: touch;

2. dev mode路由跳轉(zhuǎn)后樣式丟失

原因：dev下樣式根據(jù)頁面動(dòng)態(tài)加載，瀏覽器緩存文件styles.chunk.css造成樣式不更新。
解決方案：利用版本號(hào)強(qiáng)制重載樣式文件
示例1：

// 在Layout組件中

    {title}
    {process.env.NODE_ENV !== "production" && ()}

示例2：

// 在_app.js中
import Router from "next/router";

Router.events.on("routeChangeComplete", () => {
  if (process.env.NODE_ENV !== "production") {
    const els = document.querySelectorAll("link[href*="/_next/static/css/styles.chunk.css"]");
    const timestamp = new Date().valueOf();
    els[0].href = "/_next/static/css/styles.chunk.css?v=" + timestamp;
  }
});

3、Android 鍵盤彈起窗口會(huì)變小，有 flex 或者 position 是 absolute 或者 fixed 布局會(huì)變

這里直接把body.height設(shè)置為瀏覽器的窗口高度。

doc.body.style.height = docEl.clientHeight + "px";

4、跨域及傳遞cookie的問題

第一步，登錄成功后api服務(wù)器返回cookie。

跨域訪問要接收cookie，解決辦法也很簡(jiǎn)單只需要API服務(wù)器根據(jù)請(qǐng)求地址設(shè)置Access-Control-Allow-Origin的值為請(qǐng)求地址的ip就可以了（測(cè)試環(huán)境可以動(dòng)態(tài)設(shè)置這個(gè)ip，生產(chǎn)可以設(shè)置指定的域名或者ip地址）。

第二步，瀏覽器自動(dòng)緩存，再后續(xù)請(qǐng)求中攜帶此cookie。

fetch或axois請(qǐng)求都默認(rèn)不帶cookie，需要通過option配置打開。

- fetch要配置`{ credentials: "include", mode: "cors" }`

- axois要配置`axios.defaults.withCredentials=true;`

另外，還可以通過服務(wù)器代理走內(nèi)網(wǎng)訪問api。

以下為我們公司所采用的解決方案：

為了解決跨域以及部署不同服務(wù)器需要修改 api 地址的問題，我們使用前端服務(wù)器代理 + dns 解析。整個(gè)流程如下圖所示：

通過NODE_ENV環(huán)境變量來配置開發(fā)和生產(chǎn)的地址。在env-config.js中

const isProd = process.env.NODE_ENV === "production";
process.env.BACKEND_URL = isProd ? "/relative_url" : "http://text.api.com";
process.env.BACKEND_URL_SERVER_SIDE = isProd ? "http://bff.api.com" : "https://prod.api.com";

module.exports = {
  "process.env.BACKEND_URL": process.env.BACKEND_URL, // 客戶端渲染請(qǐng)求，是個(gè)相對(duì)地址，在前端服務(wù)器被代理到API服務(wù)器
  "process.env.BACKEND_URL_SERVER_SIDE": process.env.BACKEND_URL_SERVER_SIDE, // 服務(wù)端渲染請(qǐng)求，是API服務(wù)器地址，僅供內(nèi)網(wǎng)訪問
  "process.env.LOCATION_PREFIX": process.env.LOCATION_PREFIX
};

5、服務(wù)端渲染時(shí)帶 cookie 請(qǐng)求的問題

這里用到一個(gè)插件叫nookies。

在_app.js中全局解析cookies注入ctx:

static async getInitialProps({ Component, ctx }) {
    let pageProps = {};

    let cookies = {};
    if (ctx.isServer) {
      cookies = parseCookies(ctx);
    }
    if (Component.getInitialProps) {
      pageProps = await Component.getInitialProps({ ctx, cookies });
    }

    return { pageProps };
  }

然后就可以通過頁面請(qǐng)求：

static async getInitialProps({ ctx }) {
    const { store, req, isServer, cookies } = ctx;
    store.dispatch(setNav({ navTitle: "Home", isHome: true }));
    store.dispatch(getDataStart({ settings: { isServer, cookies } }));
  }

在proxyFetch中就會(huì)根據(jù)isServer的值來分辨是服務(wù)端API請(qǐng)求還是客戶端API請(qǐng)求。服務(wù)端請(qǐng)求會(huì)把cookies寫入Fetch的header中。

const prefix = isServer ? process.env.BACKEND_URL_SERVER_SIDE : process.env.BACKEND_URL;
isServer && (this.headers["cookie"] = "EGG_SESS=" + cookies["EGG_SESS"] + ";";)
// fetch核心
fetch(prefix + url, { headers: this.headers, ...this.init, ...options })

6、需要部署到域名下的二級(jí)目錄如：www.example.com/project

在某些公司的業(yè)務(wù)場(chǎng)景下：如共享cookie等需求，則需要將項(xiàng)目部署到域名的一個(gè)二級(jí)目錄下。

這時(shí)需要修改配置文件next.config.js：

module.exports = withSass({
    assetPrefix: process.env.NODE_ENV === "production" ? "/project" : ""
});

這個(gè)配置文件是修改next在build的時(shí)候指向的根目錄地址。但是由于Next.js的路由根目錄為pages，客戶端的路由跳轉(zhuǎn)后，生成的window.location.href地址會(huì)忽略二級(jí)目錄。

例如：假設(shè)我們的服務(wù)器地址為http://www.example.com/project，然后在首頁使用Router.push("/login")跳轉(zhuǎn)登錄頁面，瀏覽器會(huì)直接追加到域名+端口后生成http://www.example.com/login的地址。而我們實(shí)際的服務(wù)器地址是http://www.example.com/projec...，跳轉(zhuǎn)后再刷新頁面會(huì)報(bào)404。

這時(shí)候需要使用next提供的as參數(shù)（Router.push的第二個(gè)參數(shù)，link標(biāo)簽的as屬性）。二級(jí)目錄的地址可以寫在process.env中。

每次使用路由時(shí)都要加上as參數(shù)，這時(shí)可以封裝Link組件和Router來減少多余代碼。

CustomLink.js文件

import React, { Component } from "react";
import Link from "next/link";

export default class CustomLink extends Component {
  render() {
    const { href, as: asHref, children, ...props } = this.props;
    return (
      
        {children}
      
    );
  }
}