Netmiko重试认证后TestSSH函数返回None而非预期元组问题排查

1. 重点检查重试分支的返回语句 #

这是最常见的原因：在num_tries>0的重试逻辑里，你可能只执行了函数递归调用或结果打印，但没有将重试的结果通过return传递出去。

比如错误写法：

def TestSSH(device, num_tries=2):
    try:
        # 设备连接逻辑
        return ({'notes': 'success'}, 200)
    except NetmikoAuthenticationException:
        if num_tries > 0:
            print({'notes': 'xxx'}, 401)
            TestSSH(device, num_tries-1)  # 仅调用函数但不返回结果
        else:
            return ({'notes': 'auth failed'}, 403)

这种情况下，递归调用的结果不会传递到上层函数，最终函数会因为没有明确返回值而返回None。

修正方式：在重试调用前加上return：

return TestSSH(device, num_tries-1)

2. 确认所有执行分支都有明确的return #

Python函数如果没有遇到return语句，会默认返回None。检查以下分支是否都有返回：

• 正常连接成功的分支
• 重试耗尽后的分支
• 捕获到其他异常的分支（比如NetmikoTimeoutException这类未被你捕获的异常，会直接中断函数，导致无返回值）

可以临时添加通用异常捕获排查：

except Exception as e:
    print(f"未预期异常: {str(e)}")
    return ({'notes': f'异常: {str(e)}'}, 500)

3. 跟踪函数执行路径 #

在函数的关键节点添加打印语句，确认实际执行流程是否符合预期：

def TestSSH(device, num_tries=2):
    print(f"当前重试次数剩余: {num_tries}")
    try:
        # 连接逻辑
        print("连接成功，返回结果")
        return ({'notes': 'success'}, 200)
    except NetmikoAuthenticationException:
        print("认证失败，进入重试逻辑")
        if num_tries > 0:
            result = ({'notes': 'xxx'}, 401)
            print(f"准备返回: {result}")
            return TestSSH(device, num_tries-1)
        else:
            print("重试耗尽，返回认证失败")
            return ({'notes': 'auth failed'}, 403)

通过打印信息，你可以清楚看到函数走到了哪个分支，是否执行了return语句。

4. 验证循环重试的返回逻辑 #

如果你的重试用的是循环而非递归，同样要确保循环结束后有明确的返回：

def TestSSH(device, max_tries=2):
    for i in range(max_tries):
        try:
            # 连接逻辑
            return ({'notes': 'success'}, 200)
        except NetmikoAuthenticationException:
            if i < max_tries -1:
                print({'notes': 'xxx'}, 401)
            else:
                return ({'notes': 'auth failed'}, 403)
    # 处理max_tries=0的边界情况
    return ({'notes': '未执行任何连接尝试'}, 400)

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