FastAPI应用中boto3.Session的创建位置该如何选择？

直接给结论：完全可以用全局boto3.Session，它不会无故过期，而且能帮你彻底消除每次新建会话的50-100ms延迟，下面具体说原因和实现方式：

1. boto3.Session的过期逻辑 #

Session本身只是配置和凭据的容器，它自己不会过期。真正可能过期的是Session持有的AWS凭据：

• 如果用的是IAM角色（比如EC2实例角色、EKS Pod角色）或临时凭据，boto3会自动在凭据过期前完成刷新，全局Session会自动处理这个过程，不需要你手动重建会话。
• 如果用的是长期Access Key/Secret Key，这些凭据本身没有过期时间（除非你手动在AWS控制台轮换或禁用），全局Session就更不会有过期问题。

2. 为什么要避免每次新建Session #

你遇到的50-100ms延迟，主要来自boto3初始化时加载配置文件、解析凭据、建立内部连接池这些操作。全局复用Session能一次性完成这些工作，所有后续请求直接复用资源，对FastAPI这种高并发Web服务来说，能显著降低请求的平均响应时间。

3. FastAPI中全局Session的实现方式 #

在FastAPI项目里，直接在模块级别初始化全局Session和OpenSearch客户端即可，示例代码如下：

# main.py
import boto3
from opensearchpy import OpenSearch, RequestsHttpConnection
from requests_aws4auth import AWS4Auth
from fastapi import FastAPI, Depends

# 初始化全局boto3 Session
global_boto_session = boto3.Session()

# 基于全局Session生成AWS认证对象（自动处理凭据刷新）
def get_aws_auth():
    credentials = global_boto_session.get_credentials()
    return AWS4Auth(
        credentials.access_key,
        credentials.secret_key,
        global_boto_session.region_name,
        'es',
        session_token=credentials.token
    )

# 初始化全局OpenSearch客户端（复用全局Session的凭据）
opensearch_client = OpenSearch(
    hosts=[{'host': '你的OpenSearch集群端点', 'port': 443}],
    http_auth=get_aws_auth(),
    use_ssl=True,
    verify_certs=True,
    connection_class=RequestsHttpConnection
)

# 用依赖注入提供客户端（可选，规范代码结构）
def get_opensearch():
    return opensearch_client

app = FastAPI()

@app.get("/search")
async def search_documents(client: OpenSearch = Depends(get_opensearch)):
    # 直接用全局客户端执行操作
    response = client.search(index="your-index", body={"query": {"match_all": {}}})
    return response

4. 注意事项 #

• boto3的Session和OpenSearch客户端都是线程安全的，FastAPI的多线程/异步环境下可以放心复用。
• 只有当你需要切换不同的AWS账号、区域或凭据时，才需要新建Session，否则全局实例完全够用。
• 如果你的凭据是手动指定的，记得定期轮换密钥，但这和Session本身无关，轮换后重启服务或重新初始化Session即可。

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