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 })
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。
相关推荐
-
详解使用Next.js构建服务端渲染应用
next.js简介 最近在学React.js,React官方推荐使用next.js框架作为构建服务端渲染的网站,所以今天来研究一下next.js的使用. next.js作为一款轻量级的应用框架,主要用于构建静态网站和后端渲染网站. 框架特点 使用后端渲染 自动进行代码分割(code splitting),以获得更快的网页加载速度 简洁的前端路由实现 使用webpack进行构建,支持模块热更新(Hot Module Replacement) 可与主流Node服务器进行对接(如express) 可自
-
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下样式根据页面动态加载,浏览器缓存文件st
-
vue3+ts+vite2项目实战踩坑记录
目录 1.Vite创建vue3项目 2.配置别名alias 3.引入element-plus 4.glob全局导入 5.静态资源导入 总结: 1.Vite创建vue3项目 使用 NPM: npm init @vitejs/app 使用 Yarn: yarn create @vitejs/app 一个命令快速安装vite+ts+vue3项目: npm init @vitejs/app vite-app --template vue-ts 默认构建好的目录结构是不包含router和vuex的需要手动
-
关于实现Vue3版抖音滑动插件踩坑指南
目录 起步 调研 实现思路 工程构建 代码实现 video实现 slide.vue 组合使用 视频自动播放问题 git地址 总结 起步 年前单位需要搞一个类似抖音的需求,这本应是客户端的任务,然而,不知天高地厚的我却接了下来,然而下细致调研之下,发现网上并没有成熟的方案,但是却又很多需求,各大论坛全是提问的帖子,却少有人回答和解决. 这一瞬间,俺慌了,毕竟单位的活,排期都是定死的,这时候临阵退缩,实乃下下策.于是只能撸起袖子加油干.毕竟自己揽的事,含着泪也要干完,这就是男人,一个吐沫一个钉! 调
-
Mybatis plus多租户方案的实战踩坑记录
目录 (一).方案 (二).官方多租户的方案的优化和坑 1.分析哪些需要加多租户,哪些不需要加 2.jsqlparser 这个包与pagehelper 版本不对 3.sql解析失败 4.忽略多租户不生效 总结 公司的老项目要改造多租户,于是进入了大坑,本文写点遇到的坑以及解决方案,每次遇到问题在网上搜了好久,记录下来,防止以后忘掉. (一).方案 网上有很多方案,本文只写最后一种,即:表增加租户id,实现数据隔离 方案一:增加租户id,在每一个mapper调用的地方,都手工加上租户id 例如:
-
Java 热更新 Groovy 实践及踩坑指南(推荐)
目录 Groovy 是什么? Java 为何需要 Groovy ? 热部署技术设计及实现 使用场景 风控安全——规则引擎 监控中心 活动营销 技术实现 脚本加载/更新 脚本执行 生产踩坑指南 Java8 lambda 与 Groovy 语法问题 GroovyClassLoader 加载机制导致频繁gc问题 脚本首次执行耗时高 Groovy 是什么? Apache的Groovy是Java平台上设计的面向对象编程语言.这门动态语言拥有类似Python.Ruby和Smalltalk中的一些特性,可以作
-
Vue.js项目实战之多语种网站的功能实现（租车）
首先来看一下网站效果,想写这个项目的读者可以自行下载哦,地址:https://github.com/Stray-Kite/Car: 在这个项目中,我们主要是为了学习语种切换,也就是右上角的 中文/English 功能的实现. 首先看一下模拟的后台数据src/config/modules/lang.js 文件中: 关键代码: export default { name: 'Homepage', components: { ScrollNumber }, data () { return { lan
-
Docker 安装Jenkins全过程及踩坑指南
目录 Docker安装Jenkins 1.安装过程 2.Jenkins安装npm 2.1.替换容器的源 2.2.安装nodejs和npm 3.Jenkins流水线+Docker+Maven+Githubwebhooks+Springboot 3.1.需要的插件和配置 3.1.1.插件 BlueOcean MavenIntegration 3.1.2.配置 3.1.3.安装maven 3.1.4.配置Jenkins使用Docker 3.1.5.配置Jenkins中的GitSSH 3.1.6.Git
-
vue-cli2.x旧版本卸载不掉的问题踩坑指南(附Vue脚手架安装教程)
目录 旧版本卸载 问题说明 问题解释 问题解决 总结 旧版本卸载 问题说明 vue2.x脚手架旧版本卸载不掉的问题:(卸载命令运行后输入vue --version仍一直显示旧版本) 问题解释 首先明确一点,卸载不掉肯定说明你的电脑中至少有两个地方存在脚手架,而你的卸载操作只是卸载了其中之一.而出现这个情况的原因,一般来说是你在npm的默认路径下安装过脚手架,在配置了npm全局安装路径之后又安装过脚手架,所以有两个脚手架.(顺带一提,这样的情况提示的都是默认安装路径下的vue脚手架版本) 问题解决
-
分布式爬虫scrapy-redis的实战踩坑记录
目录 一.安装redis 1.首先要下载相关依赖 2.然后编译redis 二.scrapy框架出现的问题 1.AttributeError: TaocheSpider object has no attribute make_requests_from_url 原因: 2.ValueError: unsupported format character : (0x3a) at index 9 问题: 三.scrapy正确的源代码 1.items.py文件 2.settings.py文件 3.ta
-
详解升级react-router 4 踩坑指南
一.前言 上午把近日用React做的一个新闻项目所依赖的包升级到了最新的版本,其中从react-router(2.8.1)升级到react-router(4.1.2)中出现了很多问题, 故总结一下在升级过程中遇到的问题. 二.react-router,V4版本修改内容 1. 所有组件更改为从react-router-dom导入 之前的所有路由组件均是从react-router中导入,在我之前的项目中,导入相关组件如下: //v2 import {Router,Route,hashHistory}