如何捕获Rust中chrono库DelayedFormat引发的panic错误？

问题描述 #

以下Rust脚本在传入%Y作为格式参数时运行正常，但传入%z时，format!("{}", dt.format(fmt))会触发panic：

use chrono::{NaiveDateTime};

fn func(fmt: &str) -> Result<(), String>{
    let date_str = "2020-01-01 00:00";
    let dt = NaiveDateTime::parse_from_str(date_str, "%Y-%m-%d %H:%M").unwrap();
    let formatted = format!("{}", dt.format(fmt));
    println!("formatted: {formatted}");
    Ok(())
}

fn main() {
    match func("%Y") {
        Err(_) => println!("errored"),
        Ok(_) => println!("worked"),
    }
}

原因是NaiveDateTime是无时区的日期时间类型，不支持%z这类需要时区信息的格式符，格式化时会直接panic。需要捕获这个panic并返回清晰的错误提示。

解决方案 #

可以通过std::panic::catch_unwind捕获格式化操作的panic，同时统一处理日期解析的错误，将所有异常转换为Result返回：

use chrono::{NaiveDateTime};
use std::panic;

fn func(fmt: &str) -> Result<(), String>{
    let date_str = "2020-01-01 00:00";
    // 替换unwrap，返回日期解析的具体错误
    let dt = NaiveDateTime::parse_from_str(date_str, "%Y-%m-%d %H:%M")
        .map_err(|e| format!("日期解析失败: {}", e))?;
    
    // 捕获格式化时的panic，转换为友好错误信息
    let formatted = panic::catch_unwind(|| format!("{}", dt.format(fmt)))
        .map_err(|_| {
            format!("无效的格式字符串: '{}'。注意NaiveDateTime不支持时区相关格式符（如%z、%Z）", fmt)
        })?;
    
    println!("formatted: {formatted}");
    Ok(())
}

fn main() {
    // 测试%z格式
    match func("%z") {
        Err(e) => println!("错误: {}", e),
        Ok(_) => println!("成功"),
    }

    // 测试%Y格式
    match func("%Y") {
        Err(e) => println!("错误: {}", e),
        Ok(_) => println!("成功"),
    }
}

关键说明 #

1. 替换unwrap处理解析错误：将parse_from_str的unwrap()改为map_err，把解析失败的错误转换为自定义字符串，避免解析阶段的panic。
2. 用catch_unwind捕获格式化panic：dt.format(fmt)的Display实现会在格式符不支持时触发panic，通过catch_unwind可以捕获这个异常，并返回明确的错误提示，告知用户格式无效的原因（NaiveDateTime不支持时区相关格式）。
3. 错误信息友好性：错误提示中明确指出不支持的格式符类型，帮助用户快速定位问题。

内容的提问来源于stack exchange，提问作者ignoring_gravity