Next.js项目实战踩坑指南

用户83 发布于2019-08-23 13:46 / 1991人阅读

摘要：项目实战踩坑指南移动端，滚动卡顿解决方案主容器增加样式路由跳转后样式丢失原因下样式根据页面动态加载，浏览器缓存文件造成样式不更新。跨域及传递的问题第一步，登录成功后服务器返回。第二步，浏览器自动缓存，再后续请求中携带此。

项目实战踩坑指南 1. 移动端overflow:auto，ios滚动卡顿

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

2. dev mode路由跳转后样式丢失

原因：dev下样式根据页面动态加载，浏览器缓存文件styles.chunk.css造成样式不更新。
解决方案：利用版本号强制重载样式文件
示例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 键盘弹起窗口会变小，有 flex 或者 position 是 absolute 或者 fixed 布局会变

这里直接把body.height设置为浏览器的窗口高度。

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

4、跨域及传递cookie的问题

第一步，登录成功后api服务器返回cookie。

跨域访问要接收cookie，解决办法也很简单只需要API服务器根据请求地址设置Access-Control-Allow-Origin的值为请求地址的ip就可以了（测试环境可以动态设置这个ip，生产可以设置指定的域名或者ip地址）。

第二步，浏览器自动缓存，再后续请求中携带此cookie。

fetch或axois请求都默认不带cookie，需要通过option配置打开。

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

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

另外，还可以通过服务器代理走内网访问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
};

5、服务端渲染时带 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 })

6、需要部署到域名下的二级目录如：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 (
      
        {children}
      
    );
  }
}

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/99534.html

从小白程序员一路晋升为大厂高级技术专家我看过哪些书籍？（建议收藏）

摘要：大家好，我是冰河有句话叫做投资啥都不如投资自己的回报率高。马上就十一国庆假期了，给小伙伴们分享下，从小白程序员到大厂高级技术专家我看过哪些技术类书籍。大家好，我是...

sf_wangchong 2021-09-29 09:35 评论0 收藏0
Next.js踩坑入门系列（一）— Hello Next.js!

摘要：接下来我们运行一下。因此，我们需要新建一个目录。接下在再重新启动一下试试。因为默认开启服务端渲染，也就无需我们进行任何的配置，因此现在这个极其简单的应用就是一个。代码地址参考文章服务端渲染与打造高可靠与高性能的同构解决方案写在前面说实话，我个人还是觉得文笔越来越不错了，以前的文章都是一个问题闷到天黑，文章写的有点乱由于文章过于庞大导致不是一气呵成的，思路有时候会很混乱。所以我也准备...

rockswang 2019-08-23 11:38 评论0 收藏0
Next.js踩坑入门系列（二）— 添加Antd && CSS

摘要：踩坑入门系列一二添加三目录重构再谈路由陆续更新个人对于脚手架的有一种执念，如果搭建出来就是一个首页标签跳转，实在不是我这个处女座的风格，因此第二步我就想引用框架，相信很多使用的开发者用的也都是这个框架吧。 Next.js踩坑入门系列 (一) Hello Next.js (二) 添加Antd && CSS (三) 目录重构&&再谈路由陆续更新... 个人对于脚手架的UI有一种执...

lifesimple 2019-08-23 11:38 评论0 收藏0
写给前端的区块链开发入门指南：零基础开发基于以太坊智能合约的 ICO DApp

摘要：围绕以太坊的开发生态是目前相对最成熟的，比如有开发框架，有智能合约在线集成开发环境，还有专设的开发者问答频道。 showImg(https://segmentfault.com/img/bVbaJOL?w=1200&h=514); 张泉灵说，时代抛弃我们的时候连声再见都不会说，马云说对于新兴事物，绝大多数人是看不见、看不起、看不懂、来不及。自从学完 Coursera 上的 Crypto...

sean 2019-08-22 17:19 评论0 收藏0
写给前端的区块链开发入门指南：零基础开发基于以太坊智能合约的 ICO DApp

摘要：围绕以太坊的开发生态是目前相对最成熟的，比如有开发框架，有智能合约在线集成开发环境，还有专设的开发者问答频道。 showImg(https://segmentfault.com/img/bVbaJOL?w=1200&h=514); 张泉灵说，时代抛弃我们的时候连声再见都不会说，马云说对于新兴事物，绝大多数人是看不见、看不起、看不懂、来不及。自从学完 Coursera 上的 Crypto...

yzzz 2019-06-27 18:27 评论0 收藏0