'use strict'; const fs = require('fs'); const path = require('path'); const { Controller } = require('egg'); /** * 安装包分发:版本信息(软件自动更新用) * * ⚠️ **为什么不放在 egg-static 的目录里**: * `koa-static` 命中文件后**不会再调用 next()**,任何「后置中间件」都改不了它的响应头; * 而 egg-static 生产默认强缓存一年 → 软件永远拿旧的 version.json,永远检测不到更新。 * * 所以: * - `version.json` 放在 `app/public/version/`(不在静态 prefix 下),由本控制器读文件; * - 安装包 `*.msi` 仍走 egg-static(`/download/xxx.msi`),文件名带版本号,可以长缓存。 * * 缓存策略:no-store + no-cache + Expires 0,且不产生 ETag/Last-Modified(不走 304)。 * 生产前面若还有 nginx/CDN,也要对 `/download/version.json` 关缓存。 */ class DownloadController extends Controller { /** GET /download/version.json */ async version() { const { ctx, app } = this; const file = path.join(app.baseDir, 'app/public/version/version.json'); if (!fs.existsSync(file)) { ctx.status = 404; ctx.body = { ok: false, message: 'version.json 不存在(还没打包过?)' }; return; } ctx.set('Cache-Control', 'no-store, no-cache, must-revalidate, max-age=0'); ctx.set('Pragma', 'no-cache'); ctx.set('Expires', '0'); ctx.set('X-Content-Type-Options', 'nosniff'); ctx.type = 'application/json; charset=utf-8'; ctx.body = fs.readFileSync(file); // 几百字节,直接读最省事 } } module.exports = DownloadController;