为什么mypy判定Flask Request类型参数为可选Optional类型？

错误原因 #

• 第一个系列的Optional[Request]相关报错，核心原因是你的函数签名设置了默认值request: Request = None。Python类型标注的规则中，只要参数默认值为None，无论你是否显式声明Optional，mypy都会自动将该参数的类型推断为Optional[Request]，即该参数允许为None。这个推断逻辑和你是否注释了底部无参调用main()的代码无关，mypy只会根据函数签名的定义，检查函数内部逻辑是否覆盖了参数为None的情况，你直接调用request.is_json等属性时没有做None判断，自然会抛出错误。
• 第二个Incompatible types in assignment报错，原因是Flask的Request.get_json()方法本身的返回类型是Optional[Any]：如果请求体不是合法JSON，该方法会返回None而不是抛出异常，你把可能为None的返回值直接赋值给初始化为字典类型的request_body，类型不匹配。

修复方案 #

1. 首先处理request为None的情况，二选一即可：
   • 如果你确定该函数永远只会被传入Request对象（比如是云函数的入口，平台会保证入参不为空），可以直接在函数开头加断言：assert request is not None，mypy会识别到断言后的代码里request一定不为None。
   • 如果你需要兼容参数为None的场景，可以加分支判断处理None的情况：

     def main(request: Request = None):
         if request is None:
             # 按需处理，比如本地调试时构造默认请求，或者返回错误响应
             return jsonify(message="缺少request参数"), 400
         # 后续原有逻辑
     

   • 如果你加默认值=None只是为了本地测试方便，完全可以删掉默认值，将函数签名改为def main(request: Request):，本地调试时自己构造模拟Request对象传入即可，相关None报错会直接消失。
2. 处理get_json的类型兼容问题，二选一即可：
   • 赋值时增加默认空字典兜底：request_body = request.get_json() or {}
   • 显式判断返回值是否为None：

     raw_body = request.get_json()
     if raw_body is not None:
         request_body = raw_body
     

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