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')。
真正麻烦的从来不是写断言，而是让 UTPLSQL 看见你的测试包——它对 schema、命名、注释、权限这四层非常敏感，漏掉任何一层，ut.run() 就像没听见一样。
