Firebird 2.0 ErrorCodes

Firebird 2.0 错误代码文档概述 以下是 Firebird 2.0 错误代码的分类总结，分为多个关键类别，每个类别包含常见错误及其简要说明： ### 1. 网络连接错误 - **错误代码 -902**： - 无法建立连接或监听传入连接，可能涉及网络配置或防火墙问题。 - 包括 `net_connect_listen_err`, `net_event_connect_err`, `net_event_listen_err` 等。 ### 2. 文件操作相关错误 - **错误代码 -902**： - 创建、打开、关闭或访问文件时出现问题，如路径错误、权限不足等。 - 包括 `io_create_err`, `io_open_err`, `io_close_err`, `io_delete_err`, `io_access_err`。 - **错误代码 -902**： - 主要涉及文件锁定问题，如 `file_in_use`，提示文件正被其他进程使用。 ### 3. 数据库事务与状态 - **错误代码 -904**： - 包括无效数据库句柄、数据库不可用、超出实现限制和连接池耗尽等问题。 - 具体错误如 `bad_db_handle`, `unavailable`, `imp_exc`, `nopoolids`, `bufexh`。 - **错误代码 -906**： - 测试环境中的缓冲区错误，如 `bufinuse`。 ### 4. SQL 错误与约束违反 - **错误代码 -104**： - 涉及聚合函数的错误，如在GROUP BY中使用无效表达式，或嵌套使用聚合函数。 - 其他与GROUP BY相关的错误，如不包含在聚合函数或GROUP BY中的表达式。 - **错误代码 -105**： - 与LIKE操作的无效转义序列相关。 - **错误代码 -150**： - 更新操作尝试对只读表或视图进行修改。 - 其他问题包括无法更新视图或列，以及定义视图上的约束。 ### 5. 事务处理问题 - **错误代码 -913**： - 发生死锁，可能需要回滚并重试。 - **错误代码 -901**： - 事务上下文中缺少保存点，或上下文变量未找到。 ### 6. 数据完整性问题 - **错误代码 -803**： - UNIQUE约束或PRIMARY KEY违反，如 `unique_key_violation`。 - **错误代码 -817**： - 在只读事务中尝试更新，或在只读数据库中进行写入操作。 ### 7. 备份与恢复问题 - **错误代码 -901**： - 备份或恢复过程中出现问题，如备份文件可能损坏，或缺少必需的参数。 - 包括 `gbak_restore_role_failed`, `gbak_bkup_corrupt`, `gbak_disk_space_ex` 等。 ### 8. 内存与锁管理问题 - **错误代码 -901**： - 锁冲突或等待超时，如无法解决死锁。 - **错误代码 -901**： - 表达式中存在Float到Integer的不正确转换，或字段名太长超过限制。 ### 9. 其他错误 - **错误代码 -901**： - 表达式中包含未定义的上下文变量，可能是由于变量名或命名空间错误。 - **错误代码 -902**： - 包括I/O操作中的页错误，如页损坏或校验和错误。 ### 常见错误及其原因 - 数据库文件损坏：提示数据库文件损坏，可能需要修复或恢复。 - 锁级别或模式错误：锁级别不正确，应检查事务隔离级别。 - 用户身份冲突：用户登录名与SQL角色名重复，需联系管理员。 ### 总结 Firebird 2.0 错误代码涵盖了从网络连接到数据完整性、事务处理等多个方面。了解这些错误及其原因有助于更有效地排除数据库相关问题，确保系统的稳定性和数据的安全性。