Rocket v0.5-rc 路由动态段后接文件扩展名匹配报错如何解决？

问题原因 #

Rocket v0.5的路由解析规则不允许在单个URL路径段内混合动态参数与静态字符，你写的<year>.json属于同一路径段中同时存在动态参数<year>和静态后缀.json，无法被路由解析器正确识别，因此触发了参数格式警告，后续的参数类型报错也是路由解析失败导致的连锁问题。

实现方案 #

可以通过路由配置实现需求，以下是两种常用实现方式：

方案1：单处理函数+自定义参数解析

通过实现FromParam trait统一解析路径段，一个路由同时适配两种请求：

use rocket::request::FromParam;

// 自定义参数类型，存储年份和请求格式类型
struct LeaderboardReq {
    year: u32,
    is_json: bool,
}

impl<'a> FromParam<'a> for LeaderboardReq {
    type Error = ();

    fn from_param(param: &'a str) -> Result<Self, Self::Error> {
        // 优先匹配带.json后缀的请求
        if let Some(year_raw) = param.strip_suffix(".json") {
            let year = year_raw.parse::<u32>().map_err(|_| ())?;
            return Ok(Self { year, is_json: true });
        }
        // 匹配纯年份的HTML请求
        let year = param.parse::<u32>().map_err(|_| ())?;
        Ok(Self { year, is_json: false })
    }
}

// 单路由匹配两种路径
#[get("/leaderboard/<req>")]
fn get_leaderboard(req: LeaderboardReq) -> String {
    if req.is_json {
        // JSON返回逻辑
        return format!("{{\"year\": {}, \"list\": []}}", req.year);
    }
    // HTML返回逻辑
    format!("<html><body><h1>{} 排行榜</h1></body></html>", req.year)
}

方案2：拆分双处理函数+路由优先级

如果需要拆分两个独立处理函数，可以通过rank参数调整路由匹配优先级：

// 优先级更高，优先匹配带.json后缀的请求
#[get("/leaderboard/<year_str>", rank = 1)]
fn get_leaderboard_json(year_str: &str) -> Result<String, rocket::http::Status> {
    let year = year_str
        .strip_suffix(".json")
        .and_then(|s| s.parse::<u32>().ok())
        .ok_or(rocket::http::Status::NotFound)?;
    Ok(format!("{{\"year\": {}}}", year))
}

// 优先级更低，匹配剩余的纯年份HTML请求
#[get("/leaderboard/<year>", rank = 2)]
fn get_leaderboard_html(year: u32) -> String {
    format!("<h1>{} 排行榜</h1>", year)
}

内容的提问来源于stack exchange，提问作者Netråm