ORA-24007报错说MAX_RETRIES得是非负整数，这错误咋整远程帮忙修复方案分享

ORA-24007是Oracle数据库中的一个错误代码，当你尝试创建一个高级队列（AQ）或者修改现有队列的参数时，如果为MAX_RETRIES这个参数设置了一个负数，数据库就会抛出这个错误。MAX_RETRIES指的是消息发送失败后，允许系统自动重试的最大次数，它必须是一个大于或等于0的整数，如果你设成-1，或者不小心输入了一个负数，甚至可能是在程序里用一个变量赋值，而这个变量意外地变成了负数,都会触发这个报错。

要解决这个问题，思路非常直接：就是确保你赋给MAX_RETRIES的值是一个非负整数，下面我们从几个不同的场景来看看具体怎么“整”。

使用DBMS_AQADM包创建队列时出错

这是最常见的情况，假设你正在用DBMS_AQADM.CREATE_QUEUE这个存储过程来创建一个新队列,你的SQL脚本可能看起来是这样的：

BEGIN
  DBMS_AQADM.CREATE_QUEUE(
    queue_name => 'MY_TEST_QUEUE',
    queue_table => 'MY_QUEUE_TABLE',
    queue_type => sys.dbms_aqadm.normal_queue,
    max_retries => -1  -- 这里出了问题！
  );
END;
/

很明显，这里的max_retries => -1就是罪魁祸首，修复方法就是把-1改成一个有效的数字。

• 如果你想禁止重试：设置为0，这意味着消息一旦处理失败，会立刻被移动到异常队列，不会进行任何重试。

  max_retries => 0

• 如果你想允许重试，比如5次：就设置为5。

  max_retries => 5

修改后,再重新执行这个创建语句就可以了。

使用DBMS_AQADM包修改已有队列属性时出错

如果你不是创建队列，而是在用DBMS_AQADM.ALTER_QUEUE修改一个已经存在的队列,同样可能遇到这个问题。

BEGIN
  DBMS_AQADM.ALTER_QUEUE(
    queue_name => 'MY_EXISTING_QUEUE',
    max_retries => -5  -- 这里又是个负数！
  );
END;
/

修复方法和上面一模一样，把max_retries的值改为0或正整数即可。

值来自变量或表达式，需要排查

问题没那么直观，你可能不是在SQL里直接写死了-1，而是用一个变量或者表达式来设置MAX_RETRIES，比如在PL/SQL代码块里：

DECLARE
  v_retries NUMBER := -1; -- 这个变量的值可能来自上游计算或配置，但现在是-1
BEGIN
  DBMS_AQADM.CREATE_QUEUE(
    queue_name => 'MY_QUEUE',
    queue_table => 'MY_QT',
    max_retries => v_retries  -- 传递了负数的变量值
  );
END;
/

这种情况下，你需要去检查这个变量v_retries的值是怎么来的，是不是某个计算逻辑有误？或者是从配置表里读取的值不对？你需要确保在传递给CREATE_QUEUE或ALTER_QUEUE过程之前，这个变量的值已经是一个非负整数，可以在赋值后、调用过程前,加一个简单的判断：

IF v_retries < 0 THEN
  v_retries := 5; -- 或者你期望的默认值，比如0
END IF;

通过图形化界面工具操作

如果你使用的是PL/SQL Developer、Oracle SQL Developer等图形化工具，通过点点鼠标来创建或修改队列，也可能遇到这个问题，有些工具的输入框可能没有很好地校验负数输入,或者你手动输入了一个负数。

解决方法是：

1. 找到队列的属性编辑窗口。
2. 定位到“最大重试次数”（Max Retries）或类似的输入框。
3. 检查里面的数值，确保它不是负数,然后保存修改。

总结与根本预防

ORA-24007是一个典型的参数值校验错误，修复起来不复杂，但关键是要细心，为了避免以后再次出现类似问题,可以养成以下习惯：

1. 代码审查：在提交创建或修改队列的脚本前，让同事帮忙看一眼,特别是参数值部分。
2. 设置默认值：在你的应用程序或部署脚本中，为MAX_RETRIES定义一个合理的默认值（例如3或5）,避免因为配置缺失或错误而使用非法值。
3. 参数验证：如果这个值是从外部配置（如配置文件、环境变量）动态获取的，在程序中使用它之前，一定要先进行有效性验证,检查它是否是非负整数。

遇到ORA-24007别慌，它就是在提醒你：“老铁，你设置的重试次数是个负数，这不合法，赶紧改成正的或者0！” 只要你按照上面的思路，找到设置MAX_RETRIES的地方，把它改成0、1、2、3...这样的非负整数,问题就能立刻解决。