Cargo Lambda无法识别Axum路由问题求助

问题原因 #

Cargo Lambda 默认会解析 API Gateway 风格的请求路径，将路径的第一个分段当作函数二进制文件名去查找。比如请求 /users 时，它会尝试找名为 users 的二进制文件，但你的项目只有 server 二进制，因此报错。而请求根路径 / 时，它会自动使用默认函数（即 server），所以能正常运行。

解决方法 #

方法1：配置路由映射到指定函数 #

在项目的 Cargo.toml 中添加 [package.metadata.lambda] 配置段，将所有需要的路由明确映射到你的 server 函数：

[package.metadata.lambda]
functions = {
    server = {
        handler = "server",
        routes = [
            "GET /",
            "POST /users",
            "GET /users/{id}",
            # 按需添加所有你的路由规则
        ]
    }
}

方法2：启用代理模式（推荐） #

如果不想逐个配置路由，可以开启代理模式，让所有请求直接转发到 server 函数，由 Axum 内部路由处理：

[package.metadata.lambda]
functions = {
    server = {
        handler = "server",
        proxy = true
    }
}

验证步骤 #

1. 修改 Cargo.toml 后，重启 cargo lambda watch 服务
2. 发起任意路径的请求测试，此时应该能正常匹配 Axum 的路由规则

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