//! 批量重建文章 HTML 与目录。 //! //! 用于数据迁移或修复:遍历符合条件的文章,将 Markdown 重新渲染为 HTML, //! 并更新 content_html 与 toc_html 字段。 //! Dioxus server function,注册在 `/api` 路径下。 //! 仅在 `feature = "server"` 启用的服务端构建中执行数据库更新。 use dioxus::prelude::*; #[cfg(feature = "server")] use super::helpers::get_current_admin_user; #[cfg(feature = "server")] use crate::api::error::AppError; use crate::api::posts::RebuildResult; #[cfg(feature = "server")] use crate::db::pool::get_conn; /// 单次重建批处理数量上限。 #[cfg(feature = "server")] const REBUILD_BATCH_LIMIT: i64 = 500; /// 返回给前端展示的最大错误条数。 #[cfg(feature = "server")] const MAX_DISPLAY_ERRORS: usize = 5; /// 批量重建文章 content_html 与 toc_html。 /// /// 当 `rebuild_all` 为 true 时重建所有未删除文章;否则仅重建 content_html 为空的文章。 /// 单批最多处理 500 条,渲染异常或写入失败会被捕获并汇总。 #[server(RebuildContentHtml, "/api")] pub async fn rebuild_content_html(rebuild_all: bool) -> Result { let _user = get_current_admin_user().await?; #[cfg(feature = "server")] { let mut client = get_conn().await.map_err(AppError::db_conn)?; // 根据参数构造 WHERE 条件,限制单次处理数量。 let query = if rebuild_all { format!( "SELECT id, content_md FROM posts WHERE deleted_at IS NULL ORDER BY id LIMIT {REBUILD_BATCH_LIMIT}" ) } else { format!( "SELECT id, content_md FROM posts WHERE deleted_at IS NULL AND content_html IS NULL ORDER BY id LIMIT {REBUILD_BATCH_LIMIT}" ) }; let rows = client.query(&query, &[]).await.map_err(AppError::query)?; let mut rebuilt: u64 = 0; let mut failed: u64 = 0; let mut errors: Vec = Vec::new(); // 整批 UPDATE 纳入单事务:中途断连或写入失败整批回滚,避免产生 // 「部分文章已重建」的中间态(M5)。 let tx = client.transaction().await.map_err(AppError::query)?; for row in &rows { let id: i32 = row.get(0); let content_md: String = row.get(1); // Markdown 渲染在阻塞线程池执行;spawn_blocking 的 JoinError 自动捕获 panic, // 替代原先的 catch_unwind。 let md_for_render = content_md.clone(); let rendered = match tokio::task::spawn_blocking(move || { crate::api::markdown::render_markdown_enhanced(&md_for_render) }) .await { Ok(r) => r, Err(_) => { failed += 1; if errors.len() < MAX_DISPLAY_ERRORS { errors.push(format!("文章 #{id}: 渲染异常")); } continue; } }; let toc_html = if rendered.toc_html.is_empty() { None:: } else { Some(rendered.toc_html) }; let word_count = crate::utils::text::count_words(&content_md); let reading_time = crate::utils::text::reading_time(word_count); match tx .execute( "UPDATE posts SET content_html = $1, toc_html = $2, word_count = $3, reading_time = $4 WHERE id = $5", &[ &rendered.html, &toc_html, &(word_count as i32), &(reading_time as i32), &id, ], ) .await { Ok(_) => { rebuilt += 1; } Err(e) => { // 事务内任一写入失败会使事务进入 abort 状态,后续写入都会失败; // 此时整批回滚,保证不产生中间态。 failed += 1; if errors.len() < MAX_DISPLAY_ERRORS { errors.push(format!("文章 #{id}: DB 写入失败(整批将回滚)")); } tracing::error!("rebuild UPDATE 失败,整批回滚: {:?}", e); tx.rollback().await.ok(); return Ok(RebuildResult { rebuilt: 0, failed, errors, }); } } } tx.commit().await.map_err(AppError::query)?; // 重建会修改 word_count / reading_time 等列表项字段,批量影响列表、标签云、 // 标签文章及单篇缓存;这里使用全量失效作为务实的回退策略。 if rebuilt > 0 { crate::cache::invalidate_all_post_caches(); crate::cache::invalidate_search_results(); // 递增 SSR 全局世代号(未来就绪基础设施;当前不会使 Dioxus 0.7 SSR 缓存失效)。 crate::ssr_cache::bump_global_generation(); } Ok(RebuildResult { rebuilt, failed, errors, }) } #[cfg(not(feature = "server"))] { Ok(RebuildResult { rebuilt: 0, failed: 0, errors: vec![], }) } }