diff --git a/app/server/download-send.js b/app/server/download-send.js index 26c44f5..f14d6ac 100644 --- a/app/server/download-send.js +++ b/app/server/download-send.js @@ -3,6 +3,7 @@ 'use strict'; const path = require('path'); +const log = require('./log'); // Content-Disposition 手工构造,绕开 content-disposition 包的 ASCII 兜底: // 该包会把中文名逐字替换成 ?(???.pdf),且 filename= 后紧跟 filename*= 会让 @@ -53,10 +54,36 @@ function noStore(res) { res.setHeader('Expires', '0'); } +// sendFile 失败的统一出口(所有调用方共用,不再各自 try/catch——sendFile 的失败是 +// **异步**回调,调用方外层的 try/catch 根本抓不到)。 +// +// 为什么必须有人接:没人接就落进 Express 默认错误处理器,而它在 NODE_ENV != production 时 +// 会把 err.stack 拼成 HTML 页面吐给请求方——服务端绝对路径、源码文件名+行号、依赖版本全在 +// 里面。/p/ 是匿名可达端点(public-files.js 挂在 auth 之前),一次失败就等于把内部结构 +// 公开。所以正文只留一行固定文案,细节进日志。 +// +// 4xx 一律折叠成 404:不向匿名取用方区分「不存在」与「无权限」(原来的 403/416 会变成 +// 探针,能区分路径是否存在)。 +function sendFileError(res, err, abs) { + const code = Number(err && err.status); + const notFound = !!err && (err.code === 'ENOENT' || (code >= 400 && code < 500)); + const status = notFound ? 404 : 500; + log.warn('download', (notFound ? '取不到文件:' : '发送失败:') + abs + + '(' + ((err && (err.code || err.message)) || err) + ')'); + if (res.headersSent) { if (res.destroy) res.destroy(); return; } // 已吐了半截,只能断开 + res.removeHeader('Content-Disposition'); // 进来前已按附件设过,错误响应不该带文件名 + res.status(status).type('text').send(notFound ? 'not found' : 'internal error'); +} + function sendDownload(res, abs) { noStore(res); res.setHeader('Content-Disposition', downloadDisposition(path.basename(abs))); - res.sendFile(abs, { lastModified: false, etag: false, maxAge: 0 }); + // dotfiles:'allow' 与下面的图片分支对齐。send 默认 'ignore' 会把 .env / .gitignore 这类 + // 文件当成"不存在"抛 NotFoundError——文件明明在,取用方却拿到 404,且历史版本还会连带 + // 把堆栈页吐出去(见 sendFileError)。点文件本来就是我们自己签发的,没有理由拒绝。 + res.sendFile(abs, { dotfiles: 'allow', lastModified: false, etag: false, maxAge: 0 }, function (err) { + if (err) sendFileError(res, err, abs); + }); } // 内联图片响应(公网链 GET /p/ 的图片分支):点开链接直接显示,不再被当成附件下载。 @@ -72,7 +99,10 @@ function sendInlineImage(res, abs, type) { // sandbox 不给 allow-scripts,退化成不可执行、无同源权限的文档; 引用本就不执行脚本,不受影响。 if (type === 'image/svg+xml') res.setHeader('Content-Security-Policy', 'sandbox'); // dotfiles 显式放行:read_file 的压缩产物在 .imgcache/(点目录),默认策略对其他调用方不保证。 - res.sendFile(abs, { dotfiles: 'allow', lastModified: false, etag: false, maxAge: 0 }); + // 回调同 sendDownload:图片也可能在读盘中途失败(被删/EACCES),不能漏给默认错误处理器。 + res.sendFile(abs, { dotfiles: 'allow', lastModified: false, etag: false, maxAge: 0 }, function (err) { + if (err) sendFileError(res, err, abs); + }); } module.exports = { contentDisposition, downloadDisposition, sendDownload, sendInlineImage, inlineImageType }; diff --git a/app/server/error-handler.js b/app/server/error-handler.js new file mode 100644 index 0000000..f0a867e --- /dev/null +++ b/app/server/error-handler.js @@ -0,0 +1,32 @@ +// 统一 HTTP 错误出口(Express 的四参数错误中间件,必须在所有路由之后注册)。 +// +// 存在理由:Express 默认错误处理器只有 NODE_ENV=production 时才回一句干净的 500, +// 其余环境把 err.stack 拼成 HTML 吐给请求方——里面是服务端绝对路径、源码文件名+行号、 +// 依赖版本。本地形态 NODE_ENV 通常未设置,等于默认开启。而 /p/ 这类端点匿名可达 +// (见 routes/public-files.js),一次 sendFile 失败就能把整份栈打到公网。 +// +// 策略:状态码照旧透出(body-parser 的 400/413、send 的 404 都靠它,客户端要能区分), +// 正文永远固定一句,栈只进日志。 +'use strict'; + +const log = require('./log'); + +// 只认 err.status / err.statusCode 里的合法 4xx-5xx;其余(含没状态码的普通 Error)一律 500。 +function statusOf(err) { + const s = Number(err && (err.status || err.statusCode)); + return s >= 400 && s <= 599 ? s : 500; +} + +function errorHandler(err, req, res, next) { // eslint-disable-line no-unused-vars + const status = statusOf(err); + const where = (req && req.method ? req.method + ' ' + (req.originalUrl || req.url || '') : '(unknown)'); + // 5xx = 未预期异常,栈进日志;4xx 是调用方问题,一行 message 足够。 + if (status >= 500) log.error('http', where + ' → ' + status + ':' + ((err && err.stack) || err)); + else log.warn('http', where + ' → ' + status + ':' + ((err && err.message) || err)); + + if (res.headersSent) { if (res.destroy) res.destroy(); return; } // 响应已开始,只能断开 + res.removeHeader('Content-Disposition'); // 可能已被 download-send 设过,错误体不该带文件名 + res.status(status).type('text').send(status >= 500 ? 'internal error' : 'request failed'); +} + +module.exports = { errorHandler, statusOf }; diff --git a/app/server/server.js b/app/server/server.js index 76f08d9..e70eabb 100644 --- a/app/server/server.js +++ b/app/server/server.js @@ -179,6 +179,12 @@ app.get('/api/health', (req, res) => { }); }); +// 统一错误出口:**必须最后挂**(Express 按注册顺序挑错误中间件,挂在路由前等于没挂)。 +// 没有它,任何路由漏出的异常(最典型:res.sendFile 的异步失败)都会落到 Express 默认 +// 处理器,在非 production 环境下把 err.stack 拼成 HTML 吐给请求方,泄露服务端绝对路径、 +// 源码行号与依赖版本——/p/ 是匿名可达端点,这份栈等于公开。详见 error-handler.js。 +app.use(require('./error-handler').errorHandler); + const PORT = process.env.PORT || cfg.port; // 监听地址:不设 = 0.0.0.0(容器/服务器形态,宿主机端口映射靠它)。 // 本机 local 模式由 local/start.sh 注入 HOST=127.0.0.1:单机自用不该让同一局域网的人直接访问。