PHP循环测试SNMPv3凭证时错误凭证在前导致后续有效凭证认证失败

问题根因 #

该问题是PHP内置SNMP扩展依赖的net-snmp底层库的全局缓存机制导致的：
SNMPv3协议需要先获取目标设备的引擎ID才能完成认证流程，net-snmp库默认会对同一个目标IP、同一个安全名（security_name）的认证状态、引擎ID信息做全局缓存。当排在前面的错误凭证认证失败后，缓存会标记该安全名的认证状态为失败，后续即使你新建SNMP对象、传入正确凭证，只要目标IP和安全名没有变化，底层会直接复用之前的失败缓存，不会重新发起认证，所以一直返回认证失败。
SNMPv1/v2采用团体名认证，不存在引擎ID缓存机制，因此不会触发该问题。

可行解决方案 #

方案1：清理全局SNMP缓存

在原有代码的unset($session);行后添加代码，强制清理net-snmp的全局缓存状态，适配PHP 7.1及以上版本的SNMP扩展：

// 清理SNMPv3安全参数缓存
if (function_exists('snmp_clear_security')) {
    snmp_clear_security();
}
// 强制关闭所有残留SNMP会话
SNMP::close();

方案2：调用命令行snmpget工具执行请求

命令行每次调用都是独立进程，不存在全局缓存问题，兼容性和稳定性更高，你已拼接好对应命令，调整逻辑即可使用，注意用escapeshellarg处理参数避免命令注入风险：

foreach ($credentials as $credential) {
    $cmd = 'snmpget -Oqv -v3 -l ' . escapeshellarg($credential->credentials->security_level)  .
        ' -u ' . escapeshellarg($credential->credentials->security_name) .
        ' -a ' . escapeshellarg($credential->credentials->authentication_protocol) .
        ' -A ' . escapeshellarg($credential->credentials->authentication_passphrase) .
        ' -x ' . escapeshellarg($credential->credentials->privacy_protocol) .
        ' -X ' . escapeshellarg($credential->credentials->privacy_passphrase) .
        ' ' . escapeshellarg($ip) . ' ' . escapeshellarg($oid);
    
    $result = trim(shell_exec($cmd));
    // 校验返回结果是否有效
    if (!empty($result) && !str_starts_with($result, 'Error') && !str_starts_with($result, 'Fatal')) {
        print $result . "\n";
        break;
    }
}

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