国产在线一区二区,亚洲精品a,欧美久久综合

復盤Node項目中遇到的13+常見問題和解決方案

筆者之前陸陸續續接手過幾個nodejs項目, 也參與過幾個有點意思的nodejs開源項目, 最近把其中遇到的一些問題和解決方案做一個梳理, 避免大家繼續踩坑. 話不多說我們開始吧~

1. window和mac下設置NODE_ENV變量的問題

我們都知道在前端項目中會根據不同的環境變量來處理不同的邏輯, 在nodejs中也一樣, 我們需要設置本地開發環境, 測試環境, 線上環境等, 此時有一直設置環境變量的方案是在package.json中的script屬性中設置, 如下:

"scripts": {
"start": "export NODE_ENV=development && nodemon -w src --exec \"babel-node src\"",
"build": "babel src --out-dir dist",
"run-build": "node dist",
"test": "echo \"Error: no test specified\" && exit 1"
}

從start指令中我們可以發現我們用export NODE_ENV=development來定義開發環境的環境變量，由于筆者采用的是mac電腦，所以可以用export來定義一個node環境變量. 但是在和朋友合作開發項目時發現執行yarn start后會報錯, 后面看錯誤信息才發現window下不識別export, 后面筆者發現window定義環境變量可以用set, 所以對于window用戶, 如果你使用了以上方法設置NODE_ENV, 可以采用如下方式:

"scripts": {
"start": "set NODE_ENV=development && nodemon -w src --exec \"babel-node src\""
}

2. 執行npm install發生node-gyp報錯的問題

在項目開發過程中有時候拉取新的node項目代碼后執行npm install, 會報如下錯誤:

node-gyp就是在node環境中使用的生成不同平臺不同編譯器的項目文件, 如果你遇到了相同的問題, 我們可以采用如下方案:

npm install -g node-gyp

或者直接刪除package-lock.json或者yarn.lock, 然后重新yarn install或者npm install即可, 筆者親測有效.

3. node + koa2項目中刪除已設置的cookie的解決辦法

由于HTTP是無狀態協議，所以需要cookie來區分用戶之間的身份。我們可以把cookie作為是一個由瀏覽器和服務器共同協作實現的規范。

cookie的處理分為以下3步(基礎且重要的知識)：

服務器向客戶端發送cookie
瀏覽器將cookie保存(可以在后端設置expires或者maxAge，以session形式存在)
每次瀏覽器都會將之前設置好的cookie發向服務器

在開發node后臺項目時我們經常涉及用戶管理模塊, 這意味我們需要對用戶進行登錄態管理, 在用戶退出時能及時刪除用戶的cookie, 好在koa2自帶了處理cookie的方法, 我們可以通過如下的方式設置cookie:

router.post(api.validVip,
async ctx => {
ctx.cookies.set('vid', 'xuxiaoxi', { maxAge: 24 * 3600 * 1000 });
}
);

以上我們隨便設置了一個有效期為1天的cookie, 那如果業務有變動, 需要在有效期內清空此cookie, 我們該如何處理呢? 解析來給出一個相對可用的解決方案:

ctx.cookies.set('vid', '', { maxAge: 0 });

此時客戶端的cookie將在下次請求時自動失效.

4. socket.io如何與koa/egg配合使用

我們都知道完整的socket.io通信由兩部分組成:

與NodeJS HTTP 服務器集成(或安裝在其上)的socket.io
在瀏覽器端加載的客戶端庫socket.io-client

如果我們直接使用koa或者egg, 我們需要將它們內部集成的http和socket.io做兼容, 此時我們可以這樣處理:

import koa from 'koa';
import http from 'http';
const app = new koa();
const server = http.createServer(app.callback());
const io = require('socket.io')(server);
// 正常的業務處理
// io
io.on('connection', (socket) => {
console.log('a user connected');
socket.on('doc load', (msg) => {
console.log('doc load', msg)
io.emit('getData', users)
})
});
server.listen(3000, () => {
// ...
});

通過以上的方式就可以正常的將koa和socket.io 做兼容. 后面我們就可以正常的開發IM應用啦~

5. 由于nodejs第三方模塊依賴特定node版本導致的報錯解決方案

這個情況筆者之前也遇到過, 主要原因是第三方沒有和node版本做到很好的向后兼容, 此時解決方案就是更新此第三方包到最新版本(如果還在維護的情況), 或者使用node包管理工具(n)切換到適配的node版本, 如下:

// 更新最新的包
npm i xxx@latest
// 使用包管理工具n
npm i -g n

使用n可以很方便的管理node版本, 感興趣可以嘗試一下.

6. nodejs如何創建定時任務

定時任務在后端開發中是很常見的功能之一, 其本質是根據時間規則，系統在后臺自動執行相應的任務. 在java, PHP 等后臺語言中有很豐富的定時任務的支持, 對于nodejs 這個興起之秀來說, 雖然沒有那么成熟的生態, 但是仍然有定時任務的模塊, 比如node-schedule.

Node Schedule 是用于Node.js的靈活的 cron 類和非 cron 類作業調度程序。它允許我們使用可選的重復規則來安排作業(任意函數)在特定日期執行。它在任何給定時間僅使用一個計時器(而不是每秒鐘/分鐘重新評估即將到來的作業)。

一個很實用的場景是我們想在每年的雙十一或者雙十二讓node程序自動抓取某電商的“商品羊毛”, 并推送到自己的郵箱, 此時我們就可以用Node Schedule來開啟一個定時任務來執行我們的業務操作, 筆者的很多node應用都采用了類似的模式.感興趣可以互相交流一下.

那什么是cron風格的Scheduling呢? 其github上給出了一個簡單的介紹:

所以我們可以像如下方式這樣來寫一個定時任務:

let schedule = require('node-schedule');
let testJob = schedule.scheduleJob('42 * * * *', function(){
console.log('將在未來的每個時刻的42分時執行此代碼, 比如22:42, 23:42');
});

7. 在nodejs項目中使用import, export和修飾器@decorator語法

我們都知道現在nodejs版本已經到14.0+版本了, 對最新的es語法支持的也足夠好, 但是目前仍然有一些語法不支持, 比如es的模塊導入導出(import, export), 裝飾器(@decorator)等, 此時我們要在node項目中使用這些新特性, 我們就不得不借助工具, 這里筆者采用babel7來解決上述問題, 如下:

# .babelrc
{
"presets": [
[
"@babel/preset-env",
{
"targets": {
"node": "current"
}
}
]
],
"plugins": [
["@babel/plugin-proposal-decorators", { "legacy": true }],
["@babel/plugin-proposal-class-properties", { "loose" : true }]
]
}

我們只需要在項目根目錄里新建并寫入如上文件, 并安裝babel對應的模塊即可, 如下:

yarn add
@babel/cli
@babel/core
@babel/node
@babel/plugin-proposal-class-properties
@babel/plugin-proposal-decorators
@babel/preset-env

此時就可以想寫前端項目一樣使用這些新語法特性啦~

8. nodejs中優雅的處理json文件以及提高json讀寫性能

對于nodejs優化方面其實有很多要聊的, 這里主要來說說json相關的優化方案. 我們需要從2個方面來優化, 一個就是json文件的讀寫性能, 此時我們可以采用fast-json-stringify 來大大提高json的讀寫速度, 其本質是提供了一套json-schema約束, 讓json結構更加有序, 從而提高json的讀取查詢速度. 如下使用方式:

const fastJson = require('fast-json-stringify')
const stringify = fastJson({
title: 'H5 Dooring Schema',
type: 'object',
properties: {
firstName: {
type: 'string'
},
lastName: {
type: 'string'
},
age: {
description: 'Age in years',
type: 'integer'
},
reg: {
type: 'string'
}
}
})

比如說在H5-Dooring的后臺中, 有很多需要頻繁讀寫json數據的接口, 此時使用fast-json-stringify對讀寫性能會有很大的提升.

另一方面, 我們在node 端操作json, 如果用原生的寫法會非常麻煩, 此時我們最好自己對json讀取進行封裝來提高代碼的簡約性, 或者我們直接使用第三方庫jsonfile 來輕松讀寫json文件, 如下使用案例:

const json = require('jsonfile')
const fileName = 'h5-dooring.json'
const jsonData = jsonFile.readFileSync(fileName)

9. nodejs讀取大文件報錯解決方案

在nodejs中我們可以使用兩種方式來讀寫文件, 如下:

fs.readFile() 一次性將文件讀取進內存中, 如果文件過大會導致node內存不夠而報錯
fs.createReadStream() 以文件流的方式讀取, 此時可以不用擔心文件的大小

由以上介紹可知如果我們要讀取的文件可能會很大(比如視頻等大文件), 我們一開始就要使用fs.createReadStream(), 其實如果我們需要對文件進行解析, 比如要對簡歷等文件進行逐行解析提取關鍵語料, 我們可以使用node的readline模塊, 此時我們就可以對文件進行逐行讀取并解析, 如下案例:

const fs = require("fs");
const path = require("path");
const readline = require("readline");
const readlineTask = readline.createInterface({
input: fs.createReadStream(path.join(__dirname, './h5-dooring')),
});
readlineTask.on('line', function(chunk) {
// 讀取每一行數據
});
readlineTask.on('close', function() {
//文件讀取結束的邏輯
}

10. nodejs如何開啟gzip優化網站性能

對于nodejs開啟gzip 的操作也屬于node性能優化的一部分, 經過這樣的處理可以讓我們的網站加載更快, 我們可以使用koa的koa-compress中間件來實現gzip 功能. 具體實現如下:

import koa from 'koa';
import compress from 'koa-compress';
const app = new koa();
// 開啟gzip
const options = { threshold: 2048 };
app.use(compress(options));

當然koa-compress還有很多自定義的配置項, 大家可以感受一下.

11. 解決window和linux系統下路徑分隔符不一致的問題

這個問題也是系統之間的差異導致的, 也是需要考慮的問題, 我們都知道在linux系統下路徑的分隔符為/, 比如h5-dooring/src/pages, 但是在window下解析的可能就是h5-dooring\\src\\pages這樣的路徑, 此時我們需要做適配, 不然我們部署到不同系統上報錯是必然的, 所以我們需要全局配置路徑通配符, 筆者的解決方案如下: