|
|
690e00e194
|
refactor(unwrap): 消除非测试代码中的裸 .unwrap()，改为带不变量说明的 .expect()
panic="abort" 下任何 panic 直接杀进程，与 unwrap 的「稍后处理」语义冲突。
本轮把所有可证不变量的裸 unwrap 改写为带说明的 expect，并修复 time.rs 中
u32→i32 转换在大 ms 值下的潜在溢出 panic（clamp 到 i32::MAX）。
- src/utils/time.rs: sleep_ms 的 ms.try_into().unwrap() 改为 clamp 到
i32::MAX，避免超大延时值溢出；window/set_timeout 的 expect 补充上下文说明
- src/utils/text.rs: 6 个静态正则的 unwrap 改为 expect，统一说明「编译期校验」
- src/api/{auth,comments/helpers}.rs: EMAIL_REGEX 同上
- src/api/markdown.rs: IMG_RE / TABLE_RE 同上
- src/api/rate_limit.rs: NonZeroU32::new(val.max(1)) 与 Quota::with_period
补充不变量说明
- src/api/image.rs: HeaderValue::from_str(&etag).unwrap() 改为 expect 说明
etag 仅含 ASCII hex；复用 etag_value 避免 clone
- src/middleware.rs: 静态 302 重定向响应的 unwrap 改为 expect
- src/components/post/post_content.rs、src/theme.rs: WASM 上下文 window().unwrap()
改为 expect 说明仅浏览器执行
保留的 unwrap/expect（合理不变量，已在注释中说明）：
- DB_POOL LazyLock 闭包（已有详细注释 + validate_database_url 前置校验）
- csrf.rs 静态 forbidden 响应
- highlight.rs syntect 内置 Plain Text 语法
- bin/generate_highlight_css 构建工具
- comments/* 的 #[cfg(not(server))] unreachable!() WASM stub
|
2026-07-23 18:26:19 +08:00 |
|
|
|
67406f661a
|
refactor(middleware): 抽出 ssr_generation/version_headers 中间件到 middleware.rs
main.rs 的 serve() 闭包内有两个内联 async fn 中间件
（ssr_generation_middleware、version_headers_middleware），与已抽出到
middleware.rs 的 add_cache_control/admin_guard 同类却散落在入口，无法独立测试。
将其移入 middleware.rs 作为 pub(crate) 函数，serve() 闭包改用全路径
crate::middleware::xxx 引用（与现有中间件一致），行为不变。
签名归一：原内联用 axum::http::Request<Body>，迁移后改用
axum::extract::Request（与 add_cache_control/admin_guard 一致；二者是同一
类型的别名，from_fn 接受不变）。
挂载点说明（版本头置于最外层合并 router）留在 main.rs 调用处注释，描述的是
挂载决策而非函数本身。
|
2026-07-23 13:56:51 +08:00 |
|
|
|
5b6cb7d796
|
feat(middleware): COMPRESSION_ALGORITHMS 默认值改为 off
未设置环境变量时不再默认启用全部压缩算法，改为默认关闭。显式设为
"all" 或具体算法组合仍可按需开启。
- src/middleware.rs: fallback 由 "all" 改为 "off"，同步更新文档注释
与默认值测试（compression_default_env_is_all → _is_off）
- .env.example: 示例值与说明同步更新
|
2026-07-16 11:33:14 +08:00 |
|
|
|
110be35c54
|
refactor: 抽 main.rs 中间件到 src/middleware.rs
main.rs 混合了配置校验、压缩层、cache-control、admin guard、迁移 runtime、后台任务、路由注册,其中 5 个 server-only 中间件/纯函数可独立测试。迁出到新建 src/middleware.rs(#![cfg(feature=server)]):CompressionAlgorithms + parse_compression_algorithms + compression_layer_from_env + cache_control_for_path + add_cache_control + admin_guard,连同 12 个单元测试。main.rs 调用点改为全路径 crate::middleware::xxx。无新 crate、无循环依赖。main.rs 756 -> 382 行,中间件现已可独立测试。
|
2026-07-15 18:20:56 +08:00 |
|
