'use strict'; const fs = require('fs'); const path = require('path'); const { Controller } = require('egg'); /** * 安装包分发:版本信息(软件自动更新用) * * ⚠️ **为什么不放在 egg-static 的目录里**: * `koa-static` 命中文件后**不会再调用 next()**,任何「后置中间件」都改不了它的响应头; * 而 egg-static 生产默认强缓存一年 → 软件永远拿旧的 version.json,永远检测不到更新。 * * 所以: * - 版本信息放在 `app/public/version/<平台>/version.json`(不在静态 prefix 下),由本控制器读文件: * desktop → app/public/version/desktop/version.json * (更早的版本放在 app/public/version/version.json,仍作为兜底读一次) * android_client → app/public/version/android_client/version.json * - 安装包本体仍走 egg-static(`/download/desktop/*.msi`、`/download/android_client/*.apk`), * 文件名带版本号,可以长缓存。 * * 缓存策略:no-store + no-cache + Expires 0,且不产生 ETag/Last-Modified(不走 304)。 * 生产前面若还有 nginx/CDN,也要对这些 version.json 关缓存(见 deploy-lib.cjs 的 buildFrontConf)。 */ class DownloadController extends Controller { /** GET /download/version.json(桌面端;路径不能改:老客户端写死了这个地址) */ async version() { return this.sendVersion('desktop', [ 'app/public/version/desktop/version.json', 'app/public/version/version.json', ]); } /** GET /download/android_client/version.json */ async androidVersion() { return this.sendVersion('android_client', [ 'app/public/version/android_client/version.json', ]); } /** 按候选路径顺序取第一个存在的 version.json,null 缓存直出 */ sendVersion(label, candidates) { const { ctx, app } = this; const file = candidates .map(item => path.join(app.baseDir, item)) .find(item => fs.existsSync(item)); if (!file) { ctx.status = 404; ctx.body = { ok: false, message: `${label} 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;