PL/SQL包怎么创建 PL/SQL包体编译失败怎么排查

做PL/SQL包时，最容易出问题的往往不是语法入口，而是先后顺序和规范对齐没有先想清楚。Oracle官方文档把这条链路分得很明确，包先有规范，也就是package specification，再有包体，也就是package body；规范负责声明公开对象，包体负责实现这些对象。

一、PL/SQL包怎么创建

创建包时，不建议一上来就把所有代码都塞进包体，更稳的做法是先把外部要调用的接口写进规范，再把实现写进包体。这样后面不管是调用、维护还是单独重编译，都会更清楚。

1、先写包规范

包规范用CREATE PACKAGE或CREATE OR REPLACE PACKAGE来创建，主要放对外公开的过程、函数、游标、类型和变量声明。Oracle官方说明里写得很清楚，规范负责声明这些对象，后面的包体再去定义。

2、再写包体

包体用CREATE PACKAGE BODY或CREATE OR REPLACE PACKAGE BODY来创建。官方文档明确指出，如果规范里声明了游标或子程序，也就是过程和函数，那么包体就是必须的；而且包规范和包体必须在同一个schema里。

3、公开接口写在规范内部实现放在包体

对外要调用的过程和函数先放规范里，真正内部使用的私有变量、私有过程和私有函数则放到包体里。Oracle官方对包体的说明也提到，包体除了实现规范里的公开对象，还可以声明和定义不能被外部直接引用的私有对象。

4、规范和包体的签名要先对齐

规范里声明过的子程序，包体里必须有对应定义，而且对应的标题必须逐字匹配，官方原话就是除了空白字符以外要word for word一致。实际写代码时，参数类型、顺序、模式和名字一旦对不上，后面编译就很容易出错。

5、改完后再做显式重编译

如果包已经存在，后续修改时通常直接用CREATE OR REPLACE重建；若是依赖对象修复后想重新编译现有包，Oracle也提供了ALTER PACKAGE来显式重编译规范、包体或两者一起。这样做可以避免等到运行时再触发隐式重编译。

二、PL/SQL包体编译失败怎么排查

包体编译失败时，不要一上来只盯着某一行报错，更稳的顺序是先看错误列表，再查规范和包体是否对齐，最后再做重编译。Oracle官方给出的示例本身就说明了，包体可以被创建出来但带有compilation errors，而真正定位问题要靠错误输出继续往下查。

1、先看错误明细

如果包体创建后带编译错误，Oracle官方文档明确提到可以用SHOW ERRORS去看详细错误信息。不要只看一句“created with compilation errors”，先把具体报错行号和错误号拿出来，后面的排查才不会跑偏。

2、先查规范和包体标题是否逐字一致

这是最常见也最容易漏掉的一层。官方文档明确要求，对应的子程序声明和定义标题必须逐字匹配，只允许空白不同。所以只要参数类型、顺序、名称或模式有一点不一致，包体就可能报错。

3、再查是不是声明了却没实现

Oracle官方示例里就给出了典型报错，也就是规范里声明了子程序，但包体没有正确实现，结果触发PLS-00323。排查时如果看到这类错误，就不要继续猜权限或语法，先回头检查规范里的每个公开过程、函数和游标是不是都在包体里补全了。

4、确认是不是改错了层

如果问题其实出在包规范，而你只反复编译包体，结果通常不会变好。因为Oracle官方说明里已经把规范和包体分成两个对象，规范负责接口，包体负责实现；接口一旦错了，只重编译包体通常解决不了根因。

5、修完后用ALTER PACKAGE再编译一遍

把签名、实现缺失或相关代码修好后，再用ALTER PACKAGE显式重编译包规范、包体或两者一起。官方对这个语句的说明很直接，它就是用来主动重编译包对象的，也能避免运行时才发现编译问题。

三、PL/SQL包先查哪一层

真正想把包问题排快，不要一开始就来回改整段代码，而是先按固定顺序查。更稳的做法是先查错误明细，再查规范和包体签名，再查实现是否缺失，最后再做显式重编译。因为Oracle官方文档已经把这几层关系写得很清楚，顺序对了，很多看起来复杂的包体错误很快就能缩到一两处具体问题。

1、先查错误输出

没有SHOW ERRORS或工具里的详细错误列表，后面很多判断都只能靠猜。

2、再查规范

先确认包规范里的接口声明是不是你真正想要的当前版本，避免包体一直在对旧接口做实现。

3、再查包体

确认每个公开过程、函数和游标是否都实现了，而且标题完全一致。

4、最后再重编译

当前三层都理顺后，再用ALTER PACKAGE做一次显式重编译，通常比反复删除重建更稳。

总结

PL/SQL包怎么创建PL/SQL包体编译失败怎么排查，核心不是只记住CREATE PACKAGE和CREATE PACKAGE BODY两条语句，而是先把规范和包体的职责分清，再把签名一致、实现完整和显式重编译这几层守住。只要先按规范声明，再按包体实现，出了错误先看SHOW ERRORS再回头核接口，包这条线通常就会顺很多。