Oracle数据库的错误报告体系以“ORA-”为前缀，后跟五位十进制数字，例如ORA-00933。每个错误代码都对应一条定义消息，并记录了触发该错误的内核组件和场景。尽管官方文档列出了数千个错误，但在日常运维和开发中反复出现的错误其实集中在几十个。掌握这些高频错误的分类、触发条件和排查思路，远比死记硬背更有效率。本文不打算罗列所有错误代码，而是依据实际故障处理经验，从“连接与认证”“SQL语句执行”“空间与存储管理”“DDL与对象操作”四个维度，拆解最常见错误背后的机制和修复方法。
错误代码的构成与内部定位方式
Oracle的错误代码遵循严格的分段规则。前三位通常标识出错的模块或功能域，例如ORA-00900系列属于SQL语句编译相关错误，ORA-01500系列对应数据库恢复与管理类错误，ORA-01600系列则是重做日志与归档相关错误。后两位进一步细化子问题。这种分层编码使得经验丰富的DBA一眼就能判断问题的大致范围。比如看到ORA-010XX基本都与客户端连接和认证流程有关，而ORA-031XX则指向网络服务和侦听器。
在错误发生时，Oracle服务器进程不仅返回ORA代码，还会附带一条文本消息以及可能的辅助参数。这些参数极为关键，例如ORA-00001: unique constraint (SCOTT.PK_EMP) violated，括号中的内容直接指出了约束名称，方便开发者定位。很多工程师习惯只看错误编号就匆忙搜索答案，却忽略了消息文本中的具体对象或文件名，这会让排查多绕弯路。更有效的方式是结合V$DIAG_INFO视图、alert日志和trace文件，获取完整的错误栈，尤其在处理ORA-00600或ORA-07445这类内部错误时，支撑分析的数据远不止错误代码本身。
对于云环境或RAC集群，错误号可能伴随着实例名称、节点编号等上下文信息。例如ORA-01105在集群文件系统中提示挂载不一致，就需要结合集群件日志进一步分析。因此，熟练使用ADRCI工具查询诊断数据，以及利用oerr实用程序快速获得错误解释，是DBA的基础技能。例如在命令行执行oerr ora 1555，可以立刻看到快照过旧的详细说明，比翻阅网页文档更快。
连接与认证类错误（ORA-01017/ORA-12154/ORA-12514）
ORA-01017“invalid username/password; logon denied”是最容易遇到的登录错误，但它并不总是密码输错。当数据库参数REMOTE_LOGIN_PASSWORDFILE被设置为NONE，而用户尝试使用SYSDBA远程登录时，也会抛出这个错误。还有一种场景是区分大小写的密码策略：从11g开始，SEC_CASE_SENSITIVE_LOGON参数默认为TRUE，如果应用程序仍然传递全大写的密码，就会验证失败。排查时要确认sqlnet.ora中SQLNET.AUTHENTICATION_SERVICES的配置，以及用户账户是否被锁定（可通过DBA_USERS.ACCOUNT_STATUS列查看）。
ORA-12154“TNS:could not resolve the connect identifier specified”指向的是客户端无法解析连接串。原因集中在tnsnames.ora文件缺失或者格式错误、环境变量TNS_ADMIN指向失效、或者连接串名拼写不一致。在Oracle Instant Client场景下，如果没有配置TNS_ADMIN，客户端默认不会读取任何tnsnames.ora，就会报此错误。最佳实践是用tnsping工具测试指定连接字符串，它能够打印出解析到的完整连接描述符，帮助判断是语法问题还是路径问题。
ORA-12514“TNS:listener does not currently know of service requested in connect descriptor”则发生在客户端成功到达监听器，但监听器无法将该服务名映射到任何数据库实例。常见原因是数据库实例没有向监听器动态注册，或者静态注册的服务名与实际请求不符。查看lsnrctl services的输出可以确认监听器当前已知的服务列表。如果数据库在启动后很久仍未注册，可以执行alter system register命令强制触发注册。此外，连接参数SERVER=DEDICATED和SERVER=SHARED的选择也可能影响服务的呈现方式。
SQL语句执行错误（ORA-00933/ORA-00942/ORA-01722/ORA-00001）
ORA-00933“SQL command not properly ended”经常出现在多语句拼接、缺少分号或使用了不支持的语法片段时。比如在INSERT语句尾部错误地添加了ORDER BY，或者合并多个DDL时占用了同一行而没有用PL/SQL块包裹。要处理该错误，首先要将SQL复制到SQL*Plus或SQLcl中单独执行，观察是哪条语句触发的。如果是动态SQL拼接，需要打印最终的完整语句再进行调试。有时驱动程序也会对SQL进行自动改写，导致原本正确的语法变形，这时需要查看会话跟踪事件10046产生的trace文件，分析实际送达数据库的SQL文本。
ORA-00942“table or view does not exist”表面上是对象不存在，深层原因却不限于此。如果表确实存在，很可能是当前schema不匹配、缺少对该表的SELECT权限，或者该表是通过同义词引用的，但同义词指向的实际表所在的schema被删除。在通过dblink访问时，如果dblink指向的远端数据库无法解析表名，也会将错误包装成ORA-00942返回。验证思路是查询ALL_TABLES、ALL_SYNONYMS和SESSION_ROLES，确认当前会话的实际权限集合。
ORA-01722“invalid number”和ORA-00001唯一约束违反是数据处理中占比极高的两类错误。前者通常发生在隐式类型转换失败，比如将一个包含字母的字符串列与数字进行比较，或者TO_NUMBER函数接收了非数字字符串。可以使用VALIDATE_CONVERSION函数预先检测。后者则要结合约束名定位是主键还是唯一索引，分析插入数据的业务逻辑，决定使用merge语句、异常捕获或是先删除后插入的策略。
空间与存储管理错误（ORA-01652/ORA-01555/ORA-01110）
ORA-01652“unable to extend temp segment by XX in tablespace TEMP”意味着临时表空间没有足够连续空间来分配段，常见于大型排序、哈希连接或全局临时表操作。解决分为三步：首先使用V$TEMPSEG_USAGE视图查看当前占用临时段的会话和SQL，杀掉耗用空间最大的会话；其次检查临时表空间的数据文件是否设置了AUTOEXTEND，以及maxsize限制是否过小；最后可以增加额外的临时数据文件或扩大现有文件的上限。
ORA-01555“snapshot too old”是undo管理中最经典的错误。它的触发逻辑是：一个查询需要读取的某行旧镜像，在undo表空间中已经被覆盖或清理。这往往发生在长时间运行的查询和频繁提交的写入操作并存时。解决方向包括增大undo_retention、调整undo表空间大小、优化查询使之运行更快，以及避免在游标打开期间提交过多事务。如果使用循环undo管理，还要确保undo表空间具有足够的自动扩展能力。
ORA-01110及其伴随的ORA-01157通常提示文件访问异常，例如数据文件被误删除、权限不足以读取，或者文件系统已满导致写操作失败。处理流程要格外谨慎：首先确认文件是否物理存在，通过v$recover_file和v$datafile_header视图对比文件头状态，如果只是offline或需要恢复，可以尝试recover datafile；如果文件彻底丢失，则需要从备份还原并应用归档日志进行恢复。在没有备份的情况下，只能采用特殊手段提取数据或标记文件为offline drop，再做不完全恢复。
DDL与对象操作错误（ORA-00955/ORA-02449/ORA-01031）
ORA-00955“name is already used by an existing object”在创建表、视图或同义词时很常见。它提醒对象名冲突，但清理的选择上需要谨慎：是通过rename旧对象、删除旧对象，还是修改新对象的名称。之所以说谨慎，是因为在生产库中不能随意drop表，要确认旧对象是否还有其他依赖，比如物化视图、触发器或外键约束。查询DBA_DEPENDENCIES可以梳理出所有依赖关系，再决定操作顺序。
ORA-02449“unique/primary keys in table referenced by foreign keys”在尝试drop表或truncate表时发生，表明存在外部键引用。标准方法是先找到引用该主键的表，解除或禁用外键约束，再执行目标操作。但有时表上的外键引用关系非常复杂，可以用dbms_metadata.get_ddl抽取相关约束定义，批量生成禁用和启用脚本，降低人工排查的遗漏风险。
ORA-01031“insufficient privileges”虽然广泛出现在各类权限检查中，但在DDL操作里特别需要注意直接授权和角色授权的差异。角色所包含的权限在定义者的存储过程中不生效，这是因为Oracle在编译PL/SQL对象时，角色权限处于非激活状态。所以如果过程内部建表需要CREATE TABLE权限，必须直接将此权限授予用户，而不能仅仅通过角色。排查时可以对比USER_TAB_PRIVS和USER_ROLE_PRIVS，确认权限来源。
Oracle错误代码数据库故障排查ORA-修改时间：2026-08-12 17:43:21