xzgz.top网站开发记录

xzgz.top 网站记录

主要技术栈

应用主要是由 koa 构建,其中 nextjs 只负责页面构建完成服务端渲染。以下是主要应用的技术

后台

  • Koa:网站主题内容
  • koa-router:网站后端路由
  • koa-session:应用的 session 写入
  • nodemailer:发送邮件
  • mysql2:数据库操作
  • nodemon:开发模式下热更新
  • typescript
  • ts-node:完成开发模式下运行 ts 文件
  • tsconfig-paths:修复开发模式下 tsconfig.json 里路径映射在 ts-node 下不起作用。

前台

  • Nextjs:react 的服务端渲染
  • mobx:前端应用的全局状态管理
  • sass:前端应用的样式
  • github api:完成笔记储存,及markdown文件转html功能

部署

  • 利用github的webhook进行自动化部署。
  • webhook触发后执行shell脚本完成自动拉代码、docker构建、运行应用。

    #!bin/sh
    
    exitError() {
    echo "---starting $1---"
    $1
    if [ $? -eq 0 ]; then
      echo "---$1 successfully---"
    else
      echo "!!!!!!!!!!$1 error!!!!!!!!!!"
      exit 0
    fi
    }
    
    echo "==========starting rebuild=========="
    
    cd /root/xzgz
    
    exitError "git pull"
    
    exitError "docker build -t xzgz_i ."
    docker rm -f xzgz_i
    docker stop xzgz_c
    docker rm -f xzgz_c
    exitError "docker run -d -p 3000:3000 --name xzgz_c xzgz_i"
    
    echo "==========end rebuild=========="

遇到的一些问题

tsconfig.json 里路径映射问题

开发模式下
vscode 读取 tsconfig.json 里的路径映射没有问题,引用不会报错,但是 ts-node 启动脚本时会出现路径映射丢失的问题,解决方法是使用 tsconfig-paths:

# 使用以下命令开启脚本
npx ts-node -r tsconfig-paths/register --project ./tsconfig.json app_server/index.ts

在 nodemon 的配置文件 nodemon.json 里设置

{
  "watch": ["app_server/", "types/"],
  "ext": "js,json,ts",
  "execMap": {
    "ts": "ts-node -r tsconfig-paths/register --project ./tsconfig.json"
  }
}

生产模式下
直接使用 ts-node 启动服务器不适合生产模式,使用 tsc 将 ts 文件编译成 js 文件进行运行。

tsc --project tsconfig.prod.json

生成的文件执行时和上面有同样的问题,因为 tsc 编译时不会对路径映射进行编译,直接执行会报错找不到模块。
按照 tsconfig-paths/register 的解决方法,在运行脚本之前对 Module.\_resolveFilename 进行重写,达到解析路径映射的问题。具体代码:

const Module = require("module");
const path = require("path");

// 具体的路径映射根据实际情况改动
const replaceUrl = /^@server\//;

function findModel(request, _module) {
  const pathArr = request.replace(replaceUrl, "");

  let i = _module;
  while (i) {
    const filename = path.resolve(i.path, "../");
    if (/app_server$/.test(filename)) {
      break;
    } else {
      i = _module.parent;
    }
  }

  return path.join(i.path, "../", pathArr);
}

function preRunApp() {
  var originalResolveFilename = Module._resolveFilename;

  Module._resolveFilename = function (request, _parent) {
    if (replaceUrl.test(request)) {
      const findModule = findModel(request, _parent);
      return originalResolveFilename.call(this, findModule);
    }
    return originalResolveFilename.call(this, request, _parent);
  };
}

preRunApp();

然后在执行脚本时使用命令

node -r ./preRunApp.js dist/app_server/index.js

使用 nodemailer 发送 163 邮箱时超时

nodemailer 使用 163 邮箱发邮件时遇到超时的问题,主要是因为使用 163 邮箱发送邮件时必须开启 secure:

transporter = nodemailer.createTransport({
  host: "smtp.163.com", // 第三方邮箱的主机地址
  port: 465, // 25/465, secure为true - 465;false - 25
  secure: true, // 163邮箱必须为true,outlook邮箱必须为false
  auth: {
    user: SENDER, // 发送方邮箱的账号
    pass: SMTP_CODE, // 邮箱授权密码
  },
});

生产环境请求时间数据和开发环境请求同样的数据不一致(docker 容器和系统时区不一致)

应用运行在 docker 容器中,docker 容器的日期和系统的不一致。
在 Dockerfile 里配置将系统使用时区拷贝进 docker 容器中,具体如下:

RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
RUN echo 'Asia/Shanghai' > /etc/timezone

生产环境请求接口的页面会报错,提示水合失败,开发环境没有这个问题

这个问题也是由上面的问题影响的。docker 容器里 react 的脱水执行生成时间的太平洋时间。而到了客户端注水的时候生成东 8 区时间,导致服务端和客户端渲染不一致,因此报错。

nextjs 中使用 mobx 服务端和客户端数据无法保持一致

因为 mobx 在服务端初始化时生成的数据没有被传到客户端,所以需要客户端也会完成一次初始化。某些页面需要提前在 store 里调用方法完成服务端渲染。
那么需要手动的完成 mobx 的注水过程(类似于服务端渲染的脱水注水)。使用如下方法解决:

// pages/_app.ts
function MyApp({
  Component,
  pageProps,
  store, // 重点
}: AppProps & { store: AppStore }) {
  // 注水
  const _defaultStore = initializeStore(store);
  return (
    
      
    
  );
}

MyApp.getInitialProps = async (appContext: AppContext) => {
  const { Component, ctx } = appContext;

  // 服务端完成初始化
  const store = initializeStore();
  ctx.store = store;

  let appProps = {};
  if (Component.getInitialProps) {
    appProps = await Component.getInitialProps(ctx);
  }

  return { pageProps: appProps, store };
};

// store/index.ts
class Store {
  this.user = null
  // ...
  // 补水
  hydrate(initState: Store) {
    Object.assign(this, initState);
  }
}


let store: Store;
function initializeStore(initDate?: Store): Store {
  enableStaticRendering(typeof window === "undefined");

  const _store = store ?? new Store();
  if (initDate) {
    _store.hydrate(initDate);
  }
  // 客户端渲染总是new一个新对象
  if (typeof window === "undefined") return _store;
  if (!store) store = _store;

  return _store;
}

export { initializeStore, store };

剩余问题

现在session没有写入持久层,每次重新构建导致所有用户登录失效。

欢迎大佬来我的网站留言,讨论问题。

你可能感兴趣的:(xzgz.top网站开发记录)