'use strict'; const fs = require('fs'); const path = require('path'); const httpProxy = require('http-proxy'); const serve = require('koa-static'); /** * 前端入口:**后端不再渲染任何页面**,`/` 这一侧要么反代给前端 dev server、要么托管前端构建产物 * * - **开发(`env=local`)**:把非 `/api`、`/health` 的请求反向代理到前端 dev server * (`config.frontend.devServer`,默认 `http://127.0.0.1:7301`,即 `frontend && npm run dev`)。 * 这样联调只开一个地址(后端 `:7300`),前端的热更新也照常生效(含 HMR 的 WebSocket 升级)。 * - **生产**:托管 `config.frontend.distDir`(默认 `../frontend/dist`)里的静态资源, * 找不到文件且浏览器要 HTML 时回退到 `index.html`(SPA 深链刷新不会 404)。 * - **单测(`env=unittest`)**:整体跳过(不连前端、也不要求 dist 存在), * 于是未匹配的路径还是走框架/路由自己的 404。 * * 只接管 GET/HEAD 的「非接口」请求:`/api/*`、`/health` 一律交给后面的路由。 */ module.exports = (options, app) => { const cfg = app.config.frontend || {}; const env = app.config.env; const isDev = env === 'local'; const enabled = Boolean(cfg.enable) && env !== 'unittest'; const distDir = cfg.distDir; const indexFile = path.join(distDir, 'index.html'); // 静态中间件(生产用):只管真实文件,交给 koa-static 处理缓存/条件请求 const staticMw = enabled && !isDev ? serve(distDir, { index: false, defer: false }) : null; if (enabled && isDev) { app.logger.info('[frontend] dev 反代已启用: %s(页面请求转发给前端 dev server)', cfg.devServer); // 前端 dev server 的 HMR 走 WebSocket:HTTP server 的 upgrade 事件也得转过去, // 否则页面能打开、但改代码不会热更新(升级请求没人管会直接断开) app.once('server', server => { server.on('upgrade', (req, socket, head) => { const url = String(req.url || ''); if (url.startsWith('/api/') || url === '/health') return; // 接口侧不接管 getProxy(cfg.devServer).ws(req, socket, head, { target: cfg.devServer }); }); }); } else if (enabled && staticMw) { app.logger.info('[frontend] 静态托管已启用: %s(存在 index.html = %s)', distDir, fs.existsSync(indexFile)); } return async function frontend(ctx, next) { if (!enabled || !isFrontendRequest(ctx)) return next(); if (isDev) return proxyToDevServer(ctx, cfg.devServer); // 生产:先当静态资源找,找不到再回退 index.html(SPA 路由) await staticMw(ctx, async () => {}); if (ctx.status !== 404) return; if (!fs.existsSync(indexFile)) { ctx.status = 503; ctx.type = 'html'; ctx.body = '
请在 frontend/ 执行 npm run build(或用 FRONTEND_DIST 指定目录)。
${err.message}
` + `请先启动前端:cd frontend; npm run dev(目标 ${target})