PostgreSQL 错误代码 38002 对应 SQLSTATE 类 38 中的“异常处理”类别，具体含义为“不允许修改 SQL 数据”。该报错通常出现在尝试在只读事务、不可变函数（IMMUTABLE）或稳定函数（STABLE）中执行数据修改操作（如 INSERT、UPDATE、DELETE）时。修复方法包括检查事务是否被设置为只读模式，确认自定义函数的波动性属性是否标记为 VOLATILE，或者审查触发器逻辑是否在不允许的上下文中尝试写入数据。确保数据库连接权限充足且操作上下文允许数据变更是解决此问题的关键步骤，开发者需根据具体调用栈调整函数定义或事务隔离级别。
PostgreSQL 官方文档 - 附录 A. PostgreSQL 错误代码
类 38 — 异常处理。此类错误代码表示在执行 SQL 语句期间发生了异常处理相关的错误。错误代码 38002 的具体名称为 modifying_sql_data_not_permitted，意味着当前执行的 SQL 语句试图修改数据，但在当前的执行上下文中这种修改操作是被禁止的。这通常与函数的易变性分类有关，例如在声明为 STABLE 或 IMMUTABLE 的函数中尝试执行写入操作会触发此错误。根据 SQL 标准，错误代码的前两个字符表示错误类别，而后三个字符表示在该类别内特定的条件。因此，应用程序可以通过捕获 38 类错误来判断是否发生了异常处理相关的问题，并针对 38002 代码专门处理数据修改权限受限的情况。开发者应当检查数据库会话的只读状态以及函数定义中的 VOLATILE 属性设置。
数据库开发社区 - PostgreSQL 常见错误码解析与排查
在实际数据库开发过程中，遇到 38002 错误码往往意味着程序逻辑与数据库约束发生了冲突。当用户在一个标记为只读的事务中尝试执行更新操作，或者在一个不允许侧效应的函数内部调用数据修改语句时，服务器会返回此错误。排查步骤首先应确认当前数据库连接是否处于只读模式，可以通过查询 pg_settings 视图确认 transaction_read_only 参数。其次，检查存储过程或函数的定义，确保涉及数据写入的函数被正确标记为 VOLATILE。此外，某些特定的触发器执行环境也可能限制数据修改，需要审查触发器函数的逻辑。错误报告消息的独立域中通常会提供相关的数据库对象名称，帮助定位具体是哪个操作引发了违规。建议在实际修复前备份数据并测试事务隔离级别的影响。
SQL 标准错误码说明 - GBase 8c 与 PostgreSQL 兼容性文档
SQLSTATE 值是包含五个字符的字符串，由 2 个字符的 SQL 错误类和 3 个字符的子类构成。类 38 代表异常处理，其中 38002 表示修改 SQL 数据不被允许。此错误代码遵循 SQL 标准定义，大多数情况下在不同数据库系统中具有相似的含义。在 PostgreSQL 及其兼容数据库中，该错误通常与函数的安全性分类紧密相关。如果函数被声明为免疫副作用，但内部逻辑包含了写操作，数据库引擎会阻止该操作并抛出 38002 错误。修复方案包括重新定义函数属性，或者将写操作移动到外部事务块中执行。应用程序端应当捕获该 SQLSTATE 代码，而不是依赖可能本地化的错误消息文本。对于无法识别特定错误代码的应用，可以从错误类别 38 中推断发生了异常处理类错误，从而采取相应的重试或回滚策略。
技术博客 - PostgreSQL 函数波动性与错误处理机制
PostgreSQL 中的函数波动性分类决定了优化器如何对待函数调用，同时也限制了函数内部可以执行的操作。IMMUTABLE 表示函数不修改数据库且依赖输入参数，STABLE 表示在一次语句执行中结果不变，而 VOLATILE 允许每次调用都不同并可修改数据。如果在非 VOLATILE 函数中执行 INSERT 或 UPDATE，系统会抛出 38002 错误。这是因为数据库为了保证查询计划的一致性和可重复性，禁止在预测为只读的上下文中进行写入。开发者在编写存储过程时，必须明确指定函数的行为特征。若业务逻辑确实需要在函数内写数据，务必使用 VOLATILE 关键字。此外，检查调用链中是否有其他函数限制了当前上下文也是必要的调试步骤，确保整个调用栈允许数据变更操作。
FAQ
38002 错误是否意味着数据库用户权限不足？
不一定，该错误更多是指当前执行上下文不允许修改数据，例如在只读事务或不可变函数中，而非用户缺乏写权限。
如何修改 PostgreSQL 函数属性以避免 38002 报错？
需要在创建或替换函数时，将 LANGUAGE 后的属性显式声明为 VOLATILE，允许函数执行侧效应如数据修改操作。
在只读事务中执行更新语句一定会报 38002 吗？
是的，如果事务被设置为只读模式，任何尝试修改数据的 SQL 语句都会被拒绝，并可能返回此类错误代码。