SAP 简单报表输出开发系列（共6篇）
第四篇：SAP 报表异常处理机制：数据校验与消息提示规范落地
一个健壮的报表不仅要能正常展示数据，还必须能够妥善处理各种"意外"------用户输入了不存在的公司代码、查询范围内没有数据、数据库连接超时......如果没有完善的异常处理，报表可能直接崩溃，或者输出空白结果而不告知原因，让用户一头雾水。本文系统梳理报表开发过程中的常见异常场景，讲解数据合法性校验、错误消息分级提示、空数据场景兼容的实现方案，帮助你将报表的健壮性和用户体验提升到生产级水平。
一、为什么报表需要异常处理？
很多新手开发的报表只有"阳光路径"：输入正确参数 → 查询有数据 → ALV正常显示。但在真实环境中，用户可能：
- 输入不存在的物料号。
- 选择的时间范围不合法（起始日期晚于结束日期）。
- 查询无数据。
- 没有执行报表的权限。
- 数据库临时锁表或连接失败。
没有异常处理的报表会：
- 直接显示空白ALV，用户不知道是没有数据还是程序出错。
- 出现短转储（Short Dump），中断用户操作。
- 返回错误但消息类型不当（如用
MESSAGE '错误' TYPE 'S'，用户可能忽略）。
因此，一套规范的异常处理机制是报表开发中不可或缺的一环。
二、报表开发中的常见异常场景
| 异常类型 | 典型场景 | 潜在后果 |
|---|---|---|
| 输入参数错误 | 公司代码不存在、日期范围颠倒、必输项为空 | 查询无结果或SQL错误 |
| 无数据 | 筛选条件过于严格，数据库无匹配记录 | 用户误以为系统故障 |
| 数据类型错误 | 用户输入的字符无法转为数字 | 选择屏幕校验失败或运行时短转储 |
| 权限不足 | 用户无权访问某张表或执行事务码 | ALV无法显示，或查询结果为空（但无提示） |
| 数据库错误 | 锁超时、连接断开、表不存在 | 程序短转储 |
| 业务逻辑异常 | 金额为负但业务不允许 | 报表统计错误，用户无感知 |
三、数据合法性校验：把问题拦截在运行前
3.1 选择屏幕校验（最常用）
在用户点击执行之前，通过AT SELECTION-SCREEN事件校验输入，可以避免无效查询浪费数据库资源。
abap
" 必输项校验
PARAMETERS: p_bukrs TYPE bukrs OBLIGATORY.
" 校验公司代码是否存在
AT SELECTION-SCREEN ON p_bukrs.
SELECT SINGLE bukrs FROM t001 INTO @DATA(lv_bukrs) WHERE bukrs = p_bukrs.
IF sy-subrc <> 0.
MESSAGE '公司代码不存在，请重新输入' TYPE 'E'.
ENDIF.
" 校验日期区间
SELECT-OPTIONS: s_erdat FOR sy-datum.
AT SELECTION-SCREEN ON s_erdat.
IF s_erdat-low > s_erdat-high AND s_erdat-high IS NOT INITIAL.
MESSAGE '起始日期不能大于结束日期' TYPE 'E'.
ENDIF.
" 跨字段校验：例如，如果选择了物料组，则物料号不能为空
PARAMETERS: p_matkl TYPE matkl.
SELECT-OPTIONS: s_matnr FOR mara-matnr.
AT SELECTION-SCREEN.
IF p_matkl IS NOT INITIAL AND s_matnr[] IS INITIAL.
MESSAGE '输入物料组时必须同时指定物料号范围' TYPE 'E'.
ENDIF.3.2 运行时数据校验
有时校验逻辑依赖于数据库查询结果（例如检查用户输入的订单号是否真实存在），可以在START-OF-SELECTION中执行。
abap
START-OF-SELECTION.
" 校验订单号是否存在（若有多个则至少存在一个）
IF s_ebeln[] IS NOT INITIAL.
SELECT COUNT(*) FROM ekko WHERE ebeln IN s_ebeln.
IF sy-subrc <> 0.
MESSAGE '没有找到匹配的采购订单' TYPE 'E'.
ENDIF.
ENDIF.注意 ：
TYPE 'E'消息会中断程序执行，因此适合在发现致命错误时使用。
四、错误消息分级提示：选对消息类型
ABAP中的MESSAGE语句支持多种消息类型，根据严重程度选择：
| 类型 | 说明 | 用户行为 | 报表适用场景 |
|---|---|---|---|
S |
成功消息 | 显示在状态栏，程序继续 | 数据保存成功等 |
I |
信息消息 | 弹出一个对话框，用户确认后继续 | 提示重要信息（如"共找到100条数据"） |
W |
警告消息 | 显示警告，用户确认后继续 | 数据不完整但仍可显示 |
E |
错误消息 | 中断当前事件块（如START-OF-SELECTION），返回选择屏幕 |
输入参数错误、无权限等 |
A |
终止消息 | 直接终止整个程序 | 严重系统错误（极少使用） |
X |
退出消息 | 终止程序并生成短转储 | 仅用于调试 |
最佳实践：
- 输入校验失败 →
TYPE 'E' - 查询无数据 →
TYPE 'S'或TYPE 'W'，并提示"没有数据"，然后退出，不显示ALV - 查询成功 → 可以
TYPE 'S'显示"已加载XXX条数据" - 权限不足 →
TYPE 'E'或TYPE 'A'（取决于业务）
abap
" 示例：查询无数据时友好提示
SELECT ... INTO TABLE lt_data WHERE ...
IF sy-subrc <> 0.
MESSAGE '未找到符合条件的记录，请调整筛选条件' TYPE 'S' DISPLAY LIKE 'W'.
RETURN. " 不再执行后续ALV显示
ENDIF.技巧 ：
DISPLAY LIKE可以改变消息的图标，例如将TYPE 'S'显示为警告图标：MESSAGE '...' TYPE 'S' DISPLAY LIKE 'W'。
五、空数据场景兼容：不显示空白ALV
当查询结果为空时，直接调用ALV函数会显示一个空表格（只有标题行），用户可能困惑。更好的做法是：
- 检测到无数据后，提示用户并跳过ALV调用。
- 如果业务上允许空表，可以显示ALV，但添加一条"无数据"的说明行。
方案一：跳过ALV
abap
IF lt_data IS INITIAL.
MESSAGE '没有数据' TYPE 'W'.
RETURN.
ENDIF.
PERFORM f_display_alv.方案二：在ALV中显示提示行
可以通过修改输出内表，添加一行提示文本，但需要特殊处理（因为数据类型不匹配）。通常不推荐。
建议：采用方案一，简单清晰。
六、统一异常处理框架
为了保持代码整洁，可以将异常处理逻辑封装到独立的子程序或宏中。
6.1 通用消息显示子程序
abap
FORM f_message USING iv_msg TYPE string
iv_type TYPE c DEFAULT 'E'.
MESSAGE iv_msg TYPE iv_type.
ENDFORM.
" 调用
PERFORM f_message USING '物料不存在' 'E'.6.2 校验结果返回标志位
对于复杂的校验逻辑，可以使用返回标志位，避免在START-OF-SELECTION中出现大量IF嵌套。
abap
DATA: gv_error TYPE abap_bool.
FORM f_validate_input CHANGING cv_error TYPE abap_bool.
IF p_bukrs IS INITIAL.
MESSAGE '公司代码不能为空' TYPE 'E'.
cv_error = abap_true.
RETURN.
ENDIF.
...
ENDFORM.
START-OF-SELECTION.
PERFORM f_validate_input CHANGING gv_error.
IF gv_error = abap_true.
RETURN.
ENDIF.
...七、完整的异常处理报表模板
以下是一个集成输入校验、无数据处理、数据库错误捕获的完整示例。
abap
REPORT z_report_exception_demo.
*----------------------------------------------------------------------*
* 选择屏幕
*----------------------------------------------------------------------*
SELECT-OPTIONS: s_ebeln FOR ekko-ebeln OBLIGATORY.
PARAMETERS: p_bukrs TYPE ekko-bukrs DEFAULT '1000'.
*----------------------------------------------------------------------*
* 全局变量
*----------------------------------------------------------------------*
DATA: lt_ekko TYPE TABLE OF ekko,
lv_error TYPE abap_bool.
*----------------------------------------------------------------------*
* 选择屏幕校验
*----------------------------------------------------------------------*
AT SELECTION-SCREEN ON p_bukrs.
SELECT SINGLE bukrs FROM t001 INTO @DATA(lv_bukrs) WHERE bukrs = p_bukrs.
IF sy-subrc <> 0.
MESSAGE '公司代码不存在' TYPE 'E'.
ENDIF.
AT SELECTION-SCREEN ON s_ebeln.
" 至少输入一个订单号
IF s_ebeln[] IS INITIAL.
MESSAGE '订单号不能为空' TYPE 'E'.
ENDIF.
*----------------------------------------------------------------------*
* 主流程
*----------------------------------------------------------------------*
START-OF-SELECTION.
PERFORM f_get_data.
IF lv_error = abap_false.
PERFORM f_display_alv.
ENDIF.
*&---------------------------------------------------------------------*
*& Form F_GET_DATA
*&---------------------------------------------------------------------*
FORM f_get_data.
" 数据库查询
SELECT * FROM ekko INTO TABLE lt_ekko
WHERE ebeln IN s_ebeln
AND bukrs = p_bukrs.
IF sy-subrc <> 0.
MESSAGE '没有找到符合条件的采购订单' TYPE 'W'.
lv_error = abap_true.
RETURN.
ENDIF.
" 其他业务校验：例如检查净额是否为负
LOOP AT lt_ekko INTO DATA(ls_ekko).
IF ls_ekko-netwr < 0.
MESSAGE '发现负金额订单，请检查数据' TYPE 'W'.
EXIT. " 只警告，不退出
ENDIF.
ENDLOOP.
ENDFORM.
*&---------------------------------------------------------------------*
*& Form F_DISPLAY_ALV
*&---------------------------------------------------------------------*
FORM f_display_alv.
" 标准ALV调用（略）
CALL FUNCTION 'REUSE_ALV_GRID_DISPLAY'
EXPORTING
i_callback_program = sy-repid
i_structure_name = 'EKKO'
TABLES
t_outtab = lt_ekko.
ENDFORM.八、总结与最佳实践
| 异常场景 | 处理方式 | 关键点 |
|---|---|---|
| 输入参数错误 | AT SELECTION-SCREEN中使用MESSAGE TYPE 'E' |
尽早拦截，避免无效查询 |
| 无数据 | 检查内表是否为空，MESSAGE TYPE 'W'或'S'，并RETURN |
不要显示空白ALV |
| 数据库错误 | 使用TRY...CATCH（对于异常类）或检查sy-subrc |
捕捉异常，给出友好提示 |
| 权限不足 | 在程序开头调用AUTHORITY-CHECK |
提示用户联系管理员 |
| 业务逻辑异常 | 在数据处理过程中校验，使用MESSAGE TYPE 'W'或'E' |
根据严重程度决定是否中断 |
黄金法则：
- 每一个可能导致程序中断的地方，都要有对应的异常处理。
- 提示消息要明确、友好、可操作（例如"公司代码1000不存在"比"错误"有用得多）。
- 使用合适的消息类型（
E/W/I/S），不要滥用TYPE 'E'导致程序频繁中断。 - 用户无数据时，不要让他们猜------直接告诉"没有数据，请扩大筛选范围"。
下一篇我们将介绍多格式输出，实现Excel、PDF导出等常见需求。
📌 下篇预告：《SAP 报表多格式输出：Excel/PDF 批量导出功能实现》
作者 ：你的SAP学习伙伴
版本记录：2026年6月
💬 你在报表开发中遇到过哪些"用户反馈说没数据，其实是被自己过滤条件坑了"的案例？欢迎留言分享。