【Python系列】FastAPI 中的路径参数和非路径参数解析问题

💝💝💝欢迎来到我的博客，很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

• 推荐:kwan 的首页,持续学习,不断总结,共同进步,活到老学到老
• 导航
  • 檀越剑指大厂系列:全面总结 java 核心技术,jvm,并发编程 redis,kafka,Spring,微服务等
  • 常用开发工具系列:常用的开发工具,IDEA,Mac,Alfred,Git,typora 等
  • 数据库系列:详细总结了常用数据库 mysql 技术点,以及工作中遇到的 mysql 问题等
  • 新空间代码工作室:提供各种软件服务,承接各种毕业设计,毕业论文等
  • 懒人运维系列:总结好用的命令,解放双手不香吗?能用一个命令完成绝不用两个操作
  • 数据结构与算法系列:总结数据结构和算法,不同类型针对性训练,提升编程思维,剑指大厂

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝 ✨✨ 欢迎订阅本专栏 ✨✨

在 FastAPI 框架中，路由的配置是构建 RESTful API 的关键步骤。路由配置不仅需要正确地定义路径参数，还需要正确地处理非路径参数，以确保 API 的访问逻辑清晰且正确。然而，当路径参数和非路径参数的前缀一致时，可能会出现一些混淆，导致非预期的路由行为。本文将通过分析给出的代码示例，探讨这一问题，并提供相应的解决方案。

1.问题描述

在提供的代码示例中，我们可以看到两个路由装饰器@KBRouter.post被应用于两个不同的函数。第一个函数get接收一个路径参数id，而第二个函数get则没有路径参数，但接收一个非路径参数info。两个函数的路由路径前缀都是/collection/docs，这可能导致一些混淆。

FastAPI 路径参数和非路径参数的前缀一致,当访问非路径参数的接口时,会走到路径参数的接口中

@staticmethod
@KBRouter.post("/collection/docs/{id}", description="路径参数接口",
               summary="路径参数接口")
async def get(id: str = None):
    return {
        "code": 0,
        "data": None,
        "msg": "成功"
    }

@staticmethod
@KBRouter.post("/collection/docs/add", description="非路径参数接口",
               summary="非路径参数接口")
async def get(info: str = None):
    return {
        "code": 0,
        "data": None,
        "msg": "成功",
    }

2.问题分析

FastAPI 使用基于 Python 类型提示的参数来定义路径参数和查询参数。路径参数通过在函数参数中使用Path来声明，而非路径参数则直接作为函数参数声明。在上述代码中，第一个get函数使用Path来声明路径参数id，而第二个get函数则直接声明了非路径参数info。

问题出现在两个函数的路由路径前缀相同，但一个是路径参数，另一个是非路径参数。当客户端发送请求到/collection/docs/add时，FastAPI 可能会错误地将请求路由到第一个get函数，因为add可以被解释为id的值。

3.解决方案

为了解决这个问题，我们需要确保路径参数和非路径参数的路由清晰区分。以下是几种可能的解决方案：

1. 更改非路径参数的路由前缀：最简单的方法是更改第二个get函数的路由前缀，以避免与路径参数的前缀冲突。例如，可以将/collection/docs/add更改为/collection/docs/non_path。

2. 使用不同的 HTTP 方法：如果逻辑允许，可以考虑为两个接口使用不同的 HTTP 方法，比如 GET 和 POST，这样可以在不改变路由前缀的情况下区分它们。

3. 明确区分路径参数和非路径参数：在设计 API 时，应该明确区分路径参数和非路径参数的使用场景，避免在同一个前缀下同时使用它们。

4. 使用请求体来传递非路径参数：如果非路径参数的数据量较大或者需要更复杂的数据结构，可以考虑使用请求体（如 JSON）来传递这些参数，而不是通过查询参数。

5. 增加 API 文档和版本控制：通过增加详细的 API 文档和版本控制，可以帮助开发者和用户更好地理解 API 的使用方法，减少因路由混淆导致的错误。

4.最佳实践

在设计和实现 FastAPI 应用时，应该遵循以下最佳实践：

• 清晰的路由设计：确保每个路由都有清晰、明确的含义，避免使用容易引起混淆的参数名或前缀。

• 合理的参数使用：合理使用路径参数和非路径参数，确保它们的使用场景和目的清晰。

• 充分的测试：在部署 API 之前，进行充分的测试，包括单元测试和集成测试，确保 API 的行为符合预期。

• 错误处理：实现错误处理逻辑，当请求不符合预期时，能够返回清晰的错误信息。

• 遵循 RESTful 原则：设计 API 时，遵循 RESTful 原则，使用合适的 HTTP 方法和状态码来表达操作和结果。
  

5.结论

FastAPI 是一个强大而灵活的框架，但在设计 API 时，需要特别注意路径参数和非路径参数的区分，以避免路由混淆的问题。通过上述的解决方案和最佳实践，可以确保 API 的清晰性和可用性，为用户提供更好的服务。

觉得有用的话点个赞 👍🏻 呗。
❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙