Next.js项目实战踩坑指南(笔记)

更新时间：2018年11月29日 15:12:04 作者：张豆豆

这篇文章主要介绍了Next.js项目实战踩坑指南(小结)，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

前言

github: https://github.com/code-coder/next-mobile-complete-app

已经用Next.js快两个月了，项目已经提测了，这里总结一下开发过程中，以及在部署的时候遇到一些棘手的问题。

疑难杂症

1. 移动端overflow:auto，ios滚动卡顿

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

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：

// 在_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环境变量来配置开发和生产的地址。

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服务器地址，仅供内网访问
};

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 })

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

js实现文字无缝轮播
这篇文章主要为大家详细介绍了js实现文字无缝轮播，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-07-07
Typescript中类型兼容的实现
在TypeScript 编程中,类型兼容是最基础的一道检查机制,一旦代码中出现类型不兼容的表达式,编译就会失败,本文主要介绍了Typescript中类型兼容的实现,感兴趣的可以了解一下
2023-12-12
微信小程序详解如何实现付款功能
日常小程序里很多是需要付款的，那如何在小程序里实现付款呢？本篇就带着大家体验一下，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值
2022-08-08
鼠标滚轴控制文本框值的JS代码
这篇文章主要介绍了鼠标滚轴控制文本框值的JS代码，有需要的朋友可以参考一下
2013-11-11
js实现弹出窗口、页面变成灰色并不可操作的例子分享
为了更好的用户体验，现在网页中好多地方都使用弹出层。比如提示登陆，扫描微信二维码图片，论坛下载弹出扣除积分提醒等。
2014-05-05
js实现自动锁屏功能
有这么一个需求，开发了一套系统，当用户离开桌面或者一段时间不操作的话，需要把该系统所有打开页面锁定起来，本文就详细的介绍一下，感兴趣的可以了解一下
2021-06-06
javaScript强制保留两位小数的输入数校验和小数保留问题
这篇文章主要介绍了javaScript强制保留两位小数的输入数校验和小数保留问题，非常不错，具有一定的参考借鉴价值，需要的朋友参考下吧
2018-05-05
JavaScript中将number转为string的5种方法
这篇文章主要给大家介绍了关于JavaScript中将number转为string的5种方法,在JavaScript的值类型转换中,最常发生的就是string与number这两种类型值之间的相互转换,需要的朋友可以参考下
2023-07-07
微信小程序（六）：列表上拉加载下拉刷新示例
本篇文章主要介绍了微信小程序（六）：列表上拉加载下拉刷新示例，非常具有实用价值，需要的朋友可以参考下。
2017-01-01
js只执行1次的函数示例
本文通过代码示例给大家展示了如何让javascript只执行一次，如何实现这种功能呢？通过下面这段就可以轻松搞定了。
2016-07-07