Next.js項目實戰踩坑指南

時間 2019-12-06

原文原文鏈接

項目實戰踩坑指南

1. 移動端overflow:auto，ios滾動卡頓

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

2. dev mode路由跳轉後樣式丟失

緣由：dev下樣式根據頁面動態加載，瀏覽器緩存文件styles.chunk.css形成樣式不更新。
解決方案：利用版本號強制重載樣式文件
示例1：前端

// 在Layout組件中
<Head>
    <title>{title}</title>
    {process.env.NODE_ENV !== 'production' && (<link rel="stylesheet" type="text/css" href={'/_next/static/css/styles.chunk.css?v=' + Router.route} />)}
</Head>

示例2：react

// 在_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;
  }
});

三、Android 鍵盤彈起窗口會變小，有 flex 或者 position 是 absolute 或者 fixed 佈局會變

這裏直接把body.height設置爲瀏覽器的窗口高度。ios

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

四、跨域及傳遞cookie的問題

第一步，登陸成功後api服務器返回cookie。git

跨域訪問要接收cookie，解決辦法也很簡單隻須要API服務器根據請求地址設置Access-Control-Allow-Origin的值爲請求地址的ip就能夠了（測試環境能夠動態設置這個ip，生產能夠設置指定的域名或者ip地址）。github

第二步，瀏覽器自動緩存，再後續請求中攜帶此cookie。web

fetch或axois請求都默認不帶cookie，須要經過option配置打開。axios

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

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

另外，還能夠經過服務器代理走內網訪問api。api

如下爲咱們公司所採用的解決方案：跨域

爲了解決跨域以及部署不一樣服務器須要修改 api 地址的問題，咱們使用前端服務器代理 + dns 解析。整個流程以下圖所示：

經過NODE_ENV環境變量來配置開發和生產的地址。在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, // 客戶端渲染請求，是個相對地址，在前端服務器被代理到API服務器
  'process.env.BACKEND_URL_SERVER_SIDE': process.env.BACKEND_URL_SERVER_SIDE, // 服務端渲染請求，是API服務器地址，僅供內網訪問
  'process.env.LOCATION_PREFIX': process.env.LOCATION_PREFIX
};

五、服務端渲染時帶 cookie 請求的問題

這裏用到一個插件叫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 };
  }

而後就能夠經過頁面請求：

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

在proxyFetch中就會根據isServer的值來分辨是服務端API請求仍是客戶端API請求。服務端請求會把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 })

六、須要部署到域名下的二級目錄如：www.example.com/project

在某些公司的業務場景下：如共享cookie等需求，則須要將項目部署到域名的一個二級目錄下。

這時須要修改配置文件next.config.js：

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

這個配置文件是修改next在build的時候指向的根目錄地址。可是因爲Next.js的路由根目錄爲pages，客戶端的路由跳轉後，生成的window.location.href地址會忽略二級目錄。

例如：假設咱們的服務器地址爲http://www.example.com/project，而後在首頁使用Router.push('/login')跳轉登陸頁面，瀏覽器會直接追加到域名+端口後生成http://www.example.com/login的地址。而咱們實際的服務器地址是http://www.example.com/projec...，跳轉後再刷新頁面會報404。

這時候須要使用next提供的as參數（Router.push的第二個參數，link標籤的as屬性）。二級目錄的地址能夠寫在process.env中。

每次使用路由時都要加上as參數，這時能夠封裝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 (
      <Link href={href} as={asHref || process.env.LOCATION_PREFIX + this.props.href} {...props}>
        {children}
      </Link>
    );
  }
}

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。