SAP错误消息调试之七种武器：让所有的错误消息都能被定位

该博客以一个实际例子，向大家介绍了Jerry多年ABAP编程生涯积累的6种错误消息调试方法。事实上Jerry实际工作中靠着这六种方法，对于我遇到形形色色的错误消息，几乎没有遇到调试不出抛出消息准确代码位置的情况，个人觉得这些方法还是相当管用的。

具体场景：在SE38里随便输入一个并不存在的程序名，点击Display按钮，显示一个提示消息。我们的任务是通过调试或者使用Netweaver提供的其他工具找到抛出这个消息的ABAP代码的准确位置。

clipboard5,5

古龙的代表作之一《七种武器》，介绍了七件令人闻风丧胆的精妙兵器，央视的《天下足球》系列也曾用这七种武器来类比足坛上那些绝世神锋们。作为古龙的粉丝，Jerry也将这七种方法用古大师的七种武器来命名，算是向他致敬。

clipboard6,6

方法1：长生剑 - 使用SAPGUI自带的Where Used List功能

在我国古代，剑被称作“百兵之君”，常常被当作一种高贵的装饰品，从皇帝到文人都喜欢佩剑以显示身份。在金庸和古龙的名著里，大多数江湖人物使用的兵器都是剑。

下面是Jerry用来镇bug的龙泉剑：

clipboard7,7
clipboard8,8

正如剑是江湖儿女使用得最多的兵器一样，我想每一位ABAP从业人员应该都用过SAPGUI里自带的Where Used List功能。

鼠标单击SE38里显示的提示消息，查看这条消息的技术明细：DS017，其中DS代表Message Class的ID，017是这条消息在Message Class里的编号。

clipboard9,9

事务码SE91，打开DS message class，定位到第17条消息，点击这个图标使用Where Used List功能。

clipboard10,10

结果发现SAP标准程序里抛出这个消息的地方太多了。。。

clipboard11

这种情况下只得一条一条看了。注意我们在SE38里看到的消息显示前面有个绿灯，因此说明ABAP代码抛出这条消息时，是以类型S(Successful)投递的。这样我们只看结果列表里MESSAGE s017这种记录，对于MESSAGE E017直接忽略，因为后者抛出的消息前面显示的是红灯。

很快找到了这一条记录，但我还不能100%确认。此时双击进去，设置一个断点，然后回到SE38，再点一次Display按钮。

clipboard12

此时断点触发，说明ABAP include LWBABAPF00的第813行就是我要找的抛出这个提示消息的准确位置。

clipboard13

方法2：碧玉刀 - 使用ABAP调试器的watch point(观察点)功能

刀同样是一件历史非常悠久的武器，早在原始社会，古人类就用石头、蚌壳、兽骨打制成各种形状的刀。古人不仅将刀作为劳动工具，还随身携带，作为防身自卫的武器。

方法2介绍的watch point是和刀同样具有悠久历史的工具。有多古老？它伴随着SAPGUI问世的时候，Jerry的有些同事还没出生。

金庸古龙小说里，使用刀的名家也不少。金毛狮王谢逊从崆峒派那里偷了一本《七伤拳：从入门到精通》，除了七伤拳外，使用的武器就是屠龙刀。古龙小说里使刀的宗师就更多了，白天羽，傅红雪，以及手持圆月弯刀，能释放“小楼一夜听春雨”终极大招的丁鹏：

clipboard14,14
clipboard15,15

通过ABAP的关键字MESSAGE抛出消息时，系统变量SY-MSGID会自动被填充消息所属的Message Class，在Jerry这个例子里为DS，而SY-MSGNO被填充为抛出消息的编号，这个例子里为017. 因此，通过在调试器里创建watch point并维护相应的触发条件。在程序运行时，一旦触发条件满足，watch point触发，此时执行到的ABAP语句即为消息弹出的准确位置。

在命令输入栏里键入/h打开调试模式，点击Display按钮，弹出调试器：

clipboard16

在调试器的此处创建一个watch point：

clipboard17,17

条件维护如下，然后按F8继续程序的执行，之后调试器会自动在抛出消息的ABAP代码处停下来。

clipboard18

Jerry每次使用ABAP调试器里的观察点定位到我想查找的消息出处时，会感觉到丁鹏用圆月弯刀施展出“小楼一夜听春雨”将对手劈成两半的快感。

clipboard19,19

方法3：霸王枪 - 使用ABAP调试器里类型为ABAP命令的动态断点

枪，百兵之王，枪长而锋利尖锐，使用灵便，枪头刃可刺可斩，可刺穿盔甲。枪在十八般武艺中比较难学，不易掌握，俗语：“年棍，月刀，久练枪”。

“一寸长，一寸强”，正因为枪的威力比棍棒等钝器强，所以我国古代很多名将都用枪，比如《三国演义》中的赵云，马超，姜维等等：

clipboard20,20
clipboard21,21
clipboard22,22

枪在这些高武力值的武将手中施展开来，小兵们望风披靡；ABAP动态断点一出，错误消息则无所遁形。

在调试器此处创建类型为ABAP Commands的动态断点，命令设置为MESSAGE. 这样，ABAP调试器会自动在所有出现了MESSAGE关键字的地方停下来。

clipboard23,23

也可以在菜单Breakpoints->Breakpoint at处创建很多其他类型的断点，相当有用。

clipboard24,24

从方法4开始介绍的消息定位方法，已经不再局限于使用ABAP调试器，而是灵活运用SAP Netweaver里提供的各种有用工具。

方法4：多情环 - ABAP源代码静态扫描

这双环不论套住了什么，就立刻紧紧地缠住绝不脱手，就好像一个多情的女人一样，所以名叫多情环。

Jerry在学会ABAP代码静态扫描的技能后，也被代码扫描工具深深迷住了，再也摆脱不了对它的依赖。

clipboard25,25

事务码SE93里输入SE38，找到SE38实现的ABAP程序名和所处的开发包名称。

clipboard26,26

方法4的理论依据是，既然我们在SE38里看到了DS017这条消息，那么SE38的实现代码里，必定会出现MESSAGE S017这行代码。因此在方法4里我们改变思路，不再采用动态调试的办法，而选择和它相反的思路。

使用源代码扫描工具程序RS_ABAP_SOURCE_SCAN查找SE38实现代码里所有出现了MESSAGE S017的ABAP代码位置：

clipboard27

不到一秒钟，就找到了准确的位置：

clipboard28

另一个事务码CODE_SCANNER也提供了类似的ABAP代码扫描功能，界面和RS_ABAP_SOURCE_SCAN略微有点差异。

clipboard29

方法5：孔雀翎 - 使用ABAP应用性能分析工具SAT

《孔雀翎》是《七种武器》系列里Jerry最喜欢的一部，而使用SAT进行ABAP消息定位也是Jerry最喜欢的方法。

孔雀翎是个由纯金铸成、闪闪发光的圆筒，上面有两道枢纽，按下枢纽，筒里的暗器便飞射而出，据说这些暗器发出来时，美丽得就像孔雀开屏一样，辉煌灿烂，然而，就在你被这种惊人的生灵感动得目瞪神迷时，它已经要了你的性命。

clipboard30

李寻欢手中的小李飞刀，号称“例不虚发”，然而还是有miss的时候，在对决大欢喜女菩萨之时，没能做到一击必杀。孔雀翎则不同，在古龙笔下的设定里，它是一件命中率100%的暗器，孔雀翎面前没有任何人能逃生。

可惜最后被主人弄丢了，囧。

clipboard31,31

Jerry回忆自己的消息分析排错生涯，似乎想不起一种我使用了SAT但没能成功找到消息出处的情况出现，这说明SAT同孔雀翎一样，在查找ABAP消息抛出位置的领域里威力极大。

进入事务码SAT，创建一个新的跟踪Variant，Aggregation(聚合)记得设置为None,否则后续查看结果时将得不到期望看到的完整树形结构。

clipboard32,32

在Transaction字段里输入SE38，点击Execute按钮，这样就在跟踪模式下启动了SE38.

clipboard33

接着和以前一样，点击Display按钮，看到提示消息后，返回到SAT界面。这样SE38从启动到弹出提示消息，再到退出这整个过程所执行的ABAP代码都被SAT记录下来了。此时会看到一个进度条，表明SAT在格式化所记录内容的进度：

clipboard34

等到100%完成后，来到SAT的结果展示页面里，点击Call Hierarchy标签页，SE38执行的所有ABAP statement罗列如下。使用SAT自带的搜索按钮，输入MESSAGE S017, 执行即可得到结果。双击后就能进入对应的ABAP代码。

clipboard35

虽然SAT最主要的用途是用来做应用性能分析和优化的，但在Jerry介绍的这个场景里，它也起到了辅助消息定位的作用。

除此之外说句题外话，SAT的Processing Blocks界面以树形结构显示了ABAP代码的一层层调用关系，对于我们分析和学习复杂应用的执行逻辑也非常有帮助。

clipboard36

方法6：离别钩 - 使用ABAP数据库执行跟踪和性能分析工具ST05

看下古龙原文对离别钩的介绍。

“离别钩也是种武器，也是钩。”

“既然是钩，为什么要叫做离别?”

“因为这柄钩，无论钩住什么都会造成离别。如果它钩住你的手，你的手就要和腕离别；如果它钩住你的脚，你的脚就要和腿离别。”

“如果它钩住我的咽喉，我就和这个世界离别了?”

“是的。”

“你为什么要用如此残酷的武器?”

“因为我不愿被人强迫与我所爱的人离别。”

“我明白你的意思了。”

“你真的明白?”

“你用离别钩，只不过为了要相聚。”

“是的。”

Jerry想提醒大家的是，ST05虽然同离别钩一样，能有效帮助大家的消息定位工作，但如果你在客户生产系统里打开了ST05的性能分析开关，之后忘记了关掉，那说不定你可能不得不同你的工作离别了。

clipboard37,37

ABAP从业人员在怀疑应用程序的性能瓶颈出现在数据库层面时，往往都会在事务码ST05里将数据库跟踪开关打开，在跟踪模式下重新运行应用，拿到跟踪结果以此来分析数据库的性能。
在这个例子里，Jerry用ST05跟踪SE38这个事务码的执行，能得到过程中访问过的所有数据库表的名称，和访问它们的性能。

为什么Jerry要弄清楚SE38到底访问了哪些数据库表？根据经验推断，我们在SE38里输入程序的名称点击Display按钮后，SE38的实现必定会从某个数据库表(即Netweaver里存储所有ABAP程序名称的数据库表)里根据该名称进行搜索，如果搜索未命中，说明该程序并不存在，从而抛一条消息给用户。

换言之，SE38里根据用户输入去数据库表里使用OPEN SQL进行查询，和抛出提示消息，这两处代码的位置一定相邻。因此我们只要找到了SE38里查询报表名称的数据库表的位置，那么距离抛出提示消息的代码位置也不远了。

对于SE38里访问数据库表的性能，Jerry是毫不关心的，直接忽略。在ST05的结果列表里，我只盯着Object Name里显示的数据库表名称，PROGDIR在里面太显眼了。这张表存放的就是所有ABAP程序的名称，右边的就是访问该表的ABAP OPEN SQL：
SELECT WHERE ''NAME" = 'ASDASDD' AND "STATE" = 'A'.

我之前在ST05跟踪模式下随便输了个程序名ASDASDD, 所以SE38试图到表PROGDIR里查找一个名叫ASDASDD且状态为激活状态(A-Activated)的程序。

clipboard38,38