boto3中DynamoDB资源的正确类型提示如何消除Ruff警告？

原因说明 #

ServiceResource是boto3所有服务资源的通用基类，本身并没有定义Table方法——这个方法是DynamoDB专属资源实例特有的。静态类型检查工具（比如Ruff）无法推断出_dynamodb_resource()返回的实例实际是DynamoDB的专属资源，因此抛出未解析属性的警告。

可行解决方案 #

1. 使用boto3类型存根（推荐） #

安装boto3的类型存包，它提供了各服务的专属类型定义，能让类型检查工具准确识别资源的属性和方法：

pip install boto3-stubs[dynamodb]

然后修改函数的返回类型为DynamoDB专属的DynamoDBServiceResource：

from boto3.dynamodb.service_resource import DynamoDBServiceResource
import boto3

REGION = "your-region"

def _dynamodb_resource() -> DynamoDBServiceResource:
    return boto3.resource('dynamodb', region_name=REGION)

# 此时调用Table不会再触发警告
dynamodb_resource = _dynamodb_resource()
table = dynamodb_resource.Table("table")

2. 添加类型忽略注释（快速临时方案） #

如果不想引入额外依赖，可以在触发警告的代码行添加忽略注释，告诉Ruff跳过该属性的检查：

dynamodb_resource = _dynamodb_resource()
table = dynamodb_resource.Table("table")  # type: ignore[attr-defined]

3. 使用类型强制转换 #

通过typing.cast将通用的ServiceResource强制转换为DynamoDB专属类型（即使没安装类型存根，也可以用字符串类型提示）：

from typing import cast
from boto3.resources.base import ServiceResource
import boto3

REGION = "your-region"

def _dynamodb_resource() -> ServiceResource:
    return boto3.resource('dynamodb', region_name=REGION)

dynamodb_resource = cast("boto3.dynamodb.service_resource.DynamoDBServiceResource", _dynamodb_resource())
table = dynamodb_resource.Table("table")

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