utPLSQL是Oracle PL/SQL单元测试最成熟可落地的选择，但安装需满足三重上下文对齐（独立授权用户、正确SQL*Plus工作目录、操作系统写权限），测试包须以test_开头、含规范与包体、过程加@test注释，且执行用户须与安装用户一致或显式指定schema。
utPLSQL 是目前 Oracle PL/SQL 单元测试最成熟、可落地的选择，但它的安装和测试包结构是两个最容易卡住人的环节——不是语法写不对，而是权限、用户隔离、脚本路径或包体命名不匹配导致 ut.run() 静默失败或报 ORA-00942: table or view does not exist。
utPLSQL 安装失败的三个典型现象
安装不是执行一个 SQL 就完事。它依赖三重上下文对齐：
- 必须用有
CREATE PROCEDURE、CREATE TYPE、CREATE TABLE权限的独立用户（比如utp），不能直接在SYSTEM或业务用户下装； -
@ut_i_do install命令执行前，当前 SQL*Plus 会话的工作目录必须是解压后的 utPLSQL 根目录（否则找不到core子目录里的脚本，报SP2-0310: unable to open file）； - 安装脚本会动态生成临时文件（如
utplsql_types.sql），所以运行 SQL*Plus 的操作系统账户必须对当前目录有写权限，否则日志里出现SP2-0606: Cannot create SPOOL file，但安装看似“成功”实则缺对象。
测试包编译失败：为什么 CREATE OR REPLACE PACKAGE BODY test_xxx 总报 PLS-00201
这不是你函数没找到，而是 UTPLSQL 框架本身没被正确识别。常见于：
- 测试包中调用了
ut.expect()，但当前 schema 没有创建ut包的同义词：CREATE PUBLIC SYNONYM ut FOR utp.ut;； - 测试包定义了
test_add_numbers，但实际要测的函数add_numbers在另一个 schema（比如hr）下，而你没加 schema 前缀：hr.add_numbers(2,3);； - 包体里用了
ut.expect().to_equal()，但 UTPLSQL 版本低于 v3.1.10 —— 旧版只支持.to_be_like()或简单数值.to_equal()，对字符串空值或NULL处理不稳定，建议升级到 v3.1.12+。
运行测试时无输出或报 ORA-06512
BEGIN ut.run('test_add_numbers'); END; 执行后光标闪一下就返回，说明框架没捕获到任何测试用例。根本原因通常是：
- 测试包名不符合 UTPLSQL 命名约定：必须以
test_开头，且包规范（PACKAGE）和包体（PACKAGE BODY）都存在；只有包体没有包规范，ut.run()会跳过； - 测试过程没加
@test注释（v3.1+ 推荐方式）：/** @test */ PROCEDURE test_positive_numbers IS，否则 UTPLSQL 默认不扫描该过程为测试用例； - 执行
ut.run()的用户不是安装 UTPLSQL 的用户（如在hr下执行，但 UTPLSQL 装在utp下），需显式指定 schema：ut.run('utp.test_add_numbers')。
真正卡住人的地方，往往不在 PL/SQL 逻辑本身，而在 UTPLSQL 的权限上下文、schema 隔离和注释解析规则这些“看不见”的约束上。哪怕只漏掉一个 @test 注释，或少建一个同义词，整个测试就会静默失效，连错误都不报。
