Next.js项目实战踩坑指南

115 阅读 0 评论 76 点赞

我是靠谱客的博主单薄电脑，这篇文章主要介绍 Next.js项目实战踩坑指南，现在分享给大家，希望可以做个参考。

项目实战踩坑指南

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

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

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

原因：dev下样式根据页面动态加载，浏览器缓存文件styles.chunk.css造成样式不更新。
解决方案：利用版本号强制重载样式文件
示例1：

复制代码

1
2
3
4
5
// 在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：

复制代码

1
2
3
4
5
6
7
8
9
10
// 在_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设置为浏览器的窗口高度。

复制代码

1
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配置打开。

复制代码

1
2
3
- fetch要配置`{ credentials: 'include', mode: 'cors' }`
- axois要配置`axios.defaults.withCredentials=true;`

另外，还可以通过服务器代理走内网访问api。

以下为我们公司所采用的解决方案：

为了解决跨域以及部署不同服务器需要修改 api 地址的问题，我们使用前端服务器代理 + dns 解析。整个流程如下图所示：

通过NODE_ENV环境变量来配置开发和生产的地址。在env-config.js中

复制代码

1
2
3
4
5
6
7
8
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:

复制代码

1
2
3
4
5
6
7
8
9
10
11
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 };
}

然后就可以通过页面请求：

复制代码

1
2
3
4
5
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中。

复制代码

1
2
3
4
5

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：

复制代码

1
2
3
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文件

复制代码

1
2
3
4
5
6
7
8
9
10
11
12
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>
);
}
}

最后

以上就是单薄电脑最近收集整理的关于 Next.js项目实战踩坑指南的全部内容，更多相关内容请搜索靠谱客的其他文章。

本图文内容来源于网友提供，作为学习参考使用，或来自网络收集整理，版权属于原作者所有。

本文分类：运维
浏览次数：115 次浏览
发布日期：2023-12-15 00:15:05
本文链接：https://www.kaopuke.com/article/k-p-k_13_u_23_o_2_fw_13__7__2_1.html

Next.js项目实战踩坑指南

项目实战踩坑指南

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

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

3、Android 键盘弹起窗口会变小，有 flex 或者 position 是 absolute 或者 fixed 布局会变

4、跨域及传递cookie的问题

5、服务端渲染时带 cookie 请求的问题

6、需要部署到域名下的二级目录如：www.example.com/project

最后

评论列表共有 0 条评论

发表评论取消回复

Next.js项目实战踩坑指南

项目实战踩坑指南

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

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

3、Android 键盘弹起窗口会变小，有 flex 或者 position 是 absolute 或者 fixed 布局会变

4、跨域及传递cookie的问题

5、服务端渲染时带 cookie 请求的问题

6、需要部署到域名下的二级目录如：www.example.com/project

最后

相关文章

评论列表共有 0 条评论

发表评论 取消回复

微信扫一扫：分享

发表评论取消回复