mypy提示pymysql.Connection泛型缺类型参数，如何解决？

当给pymysql的Connection添加类型注解时遇到Missing type parameters for generic type "Connection" [type-arg]错误，可尝试以下几种方案解决：

1. 导入正确类型并指定泛型参数 #

pymysql的Connection在类型定义中属于泛型类型，部分场景下直接使用顶层导入的Connection可能无法识别泛型参数，可改为导入具体模块的Connection并指定游标类型：

from pymysql.connections import Connection
from pymysql.cursors import Cursor

# 明确指定游标类型作为泛型参数
conn: Connection[Cursor] = pymysql.connect(
    host="你的主机地址",
    user="数据库用户名",
    password="数据库密码",
    database="目标数据库名"
)

如果你的环境未安装官方类型注解包，先执行pip install types-pymysql更新类型定义，这能解决多数类型不匹配问题。

2. 用typing.cast强制类型转换 #

若泛型下标写法仍报错，可通过cast明确告知mypy变量的实际类型，同时保留代码的类型提示能力：

from typing import cast
import pymysql
from pymysql.cursors import Cursor

conn = cast(pymysql.Connection[Cursor], pymysql.connect(...))

3. 忽略特定行的检查（临时方案） #

如果确认代码逻辑无误，仅类型注解触发误报，可在报错行添加注释忽略该类型错误：

conn: pymysql.Connection = pymysql.connect(...)  # type: ignore[type-arg]

4. 定义游标类型变量适配泛型 #

对于需要复用游标类型的场景，可先通过TypeVar绑定游标类型范围，再注解Connection：

import pymysql
from pymysql.cursors import Cursor
from typing import TypeVar

CursorType = TypeVar("CursorType", bound=Cursor)
conn: pymysql.Connection[CursorType] = pymysql.connect(...)

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