CI中Python单元测试失败但本地正常：moto模拟失效引发UnrecognizedClientException

这种本地跑完全正常、一到CI就掉链子的问题确实挺闹心的，我帮你梳理下可能的原因和对应的解决办法：

首先，这个UnrecognizedClientException的核心问题是：你的测试没有走moto的Mock逻辑，反而去请求真实的AWS服务了——毕竟moto的Mock会完全拦截boto3的请求，根本不会用到真实的安全令牌。那为什么CI环境里Mock没生效呢？

1. 先调整Mock的初始化方式（最常见的坑） #

你现在用类变量定义mock_dynamodb2 = mock_dynamodb()，再在setUp里手动调用start，这种写法在CI的测试隔离环境下容易出现作用域问题，导致Mock没正确拦截boto3请求。

更可靠的是用moto的装饰器写法，它会自动帮你处理Mock的启动、清理，避免手动管理的疏漏：

import os
import unittest
import boto3
from moto import mock_dynamodb

os.environ['FLOW_NAME'] = 'test_flow_name'

@mock_dynamodb  # 直接装饰测试类，moto会自动处理生命周期
class TestDynamoDB(unittest.TestCase):
    def setUp(self) -> None:
        # 不需要手动调用start/stop了
        ddb_client = boto3.resource('dynamodb')
        table = ddb_client.create_table(
            # 你的表创建参数保持不变
            TableName='unit-test-data-integration-metadata',
            AttributeDefinitions=[...],
            KeySchema=[...],
            ProvisionedThroughput={...}
        )

如果坚持手动管理Mock，建议把Mock初始化移到setUp，同时在tearDown里手动停止，保证每个测试用例的Mock环境独立干净：

class TestDynamoDB(unittest.TestCase):
    def setUp(self) -> None:
        self.mock_dynamodb = mock_dynamodb()
        self.mock_dynamodb.start()
        # 清空可能干扰的AWS环境变量
        for var in ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 'AWS_SESSION_TOKEN']:
            os.environ.pop(var, None)
        # 后续创建表逻辑不变
        ddb_client = boto3.resource('dynamodb')
        ...

    def tearDown(self) -> None:
        self.mock_dynamodb.stop()

2. 检查CI环境的AWS环境变量 #

很多CI Runner会自动注入AWS相关的环境变量（比如用于部署的凭证），这些变量会被boto3优先读取，直接绕过moto的Mock——毕竟boto3会先尝试用真实凭证请求AWS。

解决办法就是在测试启动前强制清空这些变量，就像上面代码里写的那样，确保boto3完全使用moto的Mock环境。

3. 排查是否有提前初始化的boto3客户端 #

如果你的被测试代码里，在模块级别（函数/类外部）就创建了boto3客户端/资源，那这个客户端会在moto的Mock启动前就初始化完成，自然会绕过Mock去请求真实AWS。

比如被测试模块是这样的：

# 被测试的模块.py
import boto3
# 模块级别初始化，测试加载前就创建了
ddb_resource = boto3.resource('dynamodb')

def get_stream_config():
    return ddb_resource.Table('...').get_item(...)

这种情况的解决办法：要么把客户端创建移到函数内部，要么在测试里重新Patch这个客户端：

# 在测试的setUp或测试方法中
from your_module import ddb_resource
with patch('your_module.ddb_resource', boto3.resource('dynamodb')):
    # 执行测试逻辑

4. Python小版本的潜在兼容问题 #

虽然依赖版本一致，但Python 3.11的不同小版本（比如3.11.0 vs 3.11.10）可能和moto存在细微的兼容问题。可以试试把CI的Python小版本调整到和本地一致，或者升级moto到最新稳定版，看看是否能解决。

你可以先试试装饰器+清空环境变量的组合，这两个方法能解决大部分CI中moto Mock失效的问题。

备注：内容来源于stack exchange，提问作者Connor Ellis