故障排除指南¶

本指南帮助解决使用 fastapi-easy 时遇到的常见问题。

常见问题¶

问题: sqlalchemy.exc.OperationalError: could not connect to server

解决方案: - 检查数据库 URL 是否正确 - 确保数据库服务正在运行 - 检查网络连接

# 验证连接
async with engine.begin() as conn:
    await conn.execute(text("SELECT 1"))

问题: PermissionDeniedError: No permission to ...

解决方案: - 检查用户角色和权限 - 验证权限配置 - 查看审计日志

# 检查权限
if rbac.has_permission(user_role, permission):
    # 允许操作
    pass

问题: ValidationError: Invalid input

解决方案: - 检查输入数据格式 - 验证必填字段 - 查看错误详情

# 添加详细的验证错误信息
try:
    result = await adapter.create(data)
except ValidationError as e:
    logger.error(f"Validation error: {e.details}")

问题: 查询速度慢

解决方案: - 添加数据库索引 - 启用缓存 - 使用分页 - 优化查询

# 启用缓存
@CachedOperation(cache, ttl=3600)
async def get_items():
    return await adapter.get_all()

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

print(f"Debug: {variable}")

import pdb; pdb.set_trace()

完成！ 🎉