CANN opbase 算子空指针校验指南OP_CHECK_NULL_WITH_CONTEXT 宏详解与应用【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbaseOP_CHECK_NULL_WITH_CONTEXT 是 CANN opbase算子库基础框架在 include/op_common/log/log.h 中提供的空指针校验宏用于在算子 Shape 推导InferShape与 Tiling 计算等 Host 侧流程中基于上下文快速校验指针合法性并完成日志输出与错误返回。读完本文你将掌握该宏的函数原型、参数语义、底层实现原理以及它在 infershape 与 tiling 场景中的真实用法与最佳实践。功能说明在算子 Host 侧实现中InferShapeContext、TilingParseContext、TilingContext等上下文对象会通过GetInputShape()、GetInputTensor()、GetOutputShape()、GetAttrs()、GetPlatformInfo()等接口返回指向 Shape、Tensor、Attr 或平台信息的指针。这些指针可能为空例如算子描述缺失、输入配置异常若未加保护直接解引用会导致程序崩溃。OP_CHECK_NULL_WITH_CONTEXT 的作用就是根据传入的 context 上下文校验传入的指针ptr是否为nullptr。一旦发现空指针宏会自动以该算子节点名称为标识输出一条 ERROR 级别日志并立即从当前函数返回ge::GRAPH_FAILED从而将异常情况以图执行失败的形式安全上报而非触发未定义行为。该宏定义在 include/op_common/log/log.h 中属于 opbase 为算子/算子库开发者提供的公共校验与日志基础设施与OP_CHECK_IF、OP_LOGE等接口共同构成 Host 侧健壮性防护体系。函数原型OP_CHECK_NULL_WITH_CONTEXT(context, ptr)宏的声明位于 include/op_common/log/log.h其实际展开形式如下#define OP_CHECK_NULL_WITH_CONTEXT(context, ptr) \ do { \ if (unlikely((ptr) nullptr)) { \ const char* name_ (unlikely(((context) nullptr) || (context)-GetNodeName() nullptr)) ? \ nil : \ (context)-GetNodeName(); \ OP_LOGE(name_, %s is nullptr!, #ptr); \ return ge::GRAPH_FAILED; \ } \ } while (0)注意宏体通过do { ... } while (0)包裹可安全嵌入if/else分支而无悬挂 else 问题。参数说明参数名输入/输出说明context输入传入的上下文信息类型为InferShapeContext/TilingParseContext/TilingContext用于提供算子节点名称GetNodeName()作为日志标识。ptr输入待判定的指针可为const gert::Shape*、const gert::Tensor*、const gert::Attrs*、const platform_ascendc::PlatformInfo*等任意指针类型。从实现看context 实际只依赖两个能力一是可被 nullptr比较二是提供GetNodeName()方法返回const char*或可转换为字符串的类型。因此任何具备这两个接口的上下文对象都可传入官方支持的类型即文档所列的三种上下文。返回值说明当输入ptr为nullptr时宏执行return ge::GRAPH_FAILED;即以当前函数返回值的形式向上层报告图执行失败当ptr非空时宏不产生任何副作用函数继续向下执行最终正常返回ge::GRAPH_SUCCESS。ge::GRAPH_FAILED与ge::GRAPH_SUCCESS均来自graph/error_codes.h见 include/op_common/log/log.h 的包含关系是 GEGraph Engine图执行框架的标准返回码。约束说明官方文档声明无约束。但从宏实现可以推断出两条使用前提需要开发者留意只能在返回类型为ge::graphStatus或可隐式返回该枚举值的兼容类型的函数中使用。因为宏体内部直接执行return ge::GRAPH_FAILED;若所在函数返回void或其它类型将导致编译错误。仓库中的使用点如InferShape4Reduce、InferShape4Broadcast、ElewiseBaseTiling::GetPlatformInfo返回值均为ge::graphStatus与宏完全匹配宏定义位于#ifndef OP_LOG_LIBOPAPI_ONLY条件编译块内include/op_common/log/log.h即仅在非仅 libopapi模式下可用。使用前需确保编译环境未定义OP_LOG_LIBOPAPI_ONLY。宏的底层实现剖析逐行解读 include/op_common/log/log.h 中的实现可以看到四个关键设计1.unlikely分支预测提示if (unlikely((ptr) nullptr)) {unlikely定义在 include/op_common/log/log.h#define unlikely(x) __builtin_expect((x), 0) #define likely(x) __builtin_expect((x), 1)它借助 GCC/Clang 的__builtin_expect向编译器提示指针为空是小概率路径从而优化分支布局减少正常路径的分支代价。空指针校验是防御性检查正常情况下不会触发使用unlikely契合其语义。2. 上下文与节点名的空安全处理const char* name_ (unlikely(((context) nullptr) || (context)-GetNodeName() nullptr)) ? nil : (context)-GetNodeName();宏对 context 本身也做了空判断若 context 为空或GetNodeName()返回空指针则日志中的算子名称统一回退为字符串nil保证日志输出函数不会收到空指针而二次崩溃。这与 include/op_common/log/log.h 中GetOpInfo对nullptr的nil兜底策略一致。3. 日志输出与变量名内省OP_LOGE(name_, %s is nullptr!, #ptr);#ptr是预处理器的字符串化stringification操作符将传入的变量名本身转成字符串写入日志。例如传入inShape日志即输出inShape is nullptr!无需开发者手写变量名日志天然可读、可定位。OP_LOGE的定义见 include/op_common/log/log.h它会调用OP_LOGE_LIBOPAPI_REPORT记录 ERROR 级别日志并调用REPORT_INNER_ERR_MSG(EZ9999, ...)上报内部错误消息。日志记录的格式由OP_LOGE_LIBOPAPI_REPORT决定include/op_common/log/log.h[%s:%d][%s][%s][%lu] OpName:[%s] message // 即 [文件:行号][子模块OPS_BASE][函数名][线程ID] OpName:[节点名] message其中线程 ID 通过syscall(__NR_gettid)获取见 include/op_common/log/log.h模块 ID 固定为OP_MODULE_ID 63include/op_common/log/log.h。日志是否真正落盘还取决于CheckLogLevel(OP_MODULE_ID, DLOG_ERROR)的返回DLOG_ERROR等日志级别定义在 include/op_common/log/log.h。4. 失败即返回return ge::GRAPH_FAILED;校验失败立即返回配合do { } while (0)结构使宏在调用点表现为一条语句 一次提前返回语义清晰且不会影响后续代码的 else 分支。与 OP_CHECK_IF 等配套宏的组合使用OP_CHECK_NULL_WITH_CONTEXT 只负责指针是否为空这一种检查。对于更复杂的条件校验opbase 还提供了OP_CHECK_IF宏定义于 include/op_common/log/log.h#define OP_CHECK_IF(condition, log, return_expr) \ do { \ if (unlikely(condition)) { \ log; \ return_expr; \ } \ } while (0)其官方文档见 docs/en/api/op_common/math/OP_CHECK_IF.md当条件为真时输出日志并执行return表达式。两者的分工典型如下先以OP_CHECK_NULL_WITH_CONTEXT保证指针可用再用OP_CHECK_IF校验业务条件如 shape 维度、数据类型、元素个数是否合法。在 src/op_common/op_host/infershape_reduce_util.cpp 的InferShape4Reduce中可以看到这种组合的完整形态。仓库中的真实应用案例opbase 仓库中大量 Host 侧公共实现使用该宏做入口防护以下三个案例覆盖了它最主要的两种应用场景Shape 推导与 Tiling。案例一Reduce 类算子 Shape 推导infershape 场景src/op_common/op_host/infershape_reduce_util.cpp 中的InferShape4Reducege::graphStatus InferShape4Reduce(gert::InferShapeContext* context) { auto inShape context-GetInputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); auto axesTensor context-GetInputTensor(1); OP_CHECK_NULL_WITH_CONTEXT(context, axesTensor); auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape); auto attrs context-GetAttrs(); OP_CHECK_NULL_WITH_CONTEXT(context, attrs); const bool* keepDims attrs-GetAttrPointerbool(0); OP_CHECK_NULL_WITH_CONTEXT(context, keepDims); ... }这段代码正是 docs/en/api/op_common/log/OP_CHECK_NULL_WITH_CONTEXT.md 中调用示例的原型出处。它展示了该宏的典型书写习惯每获取一个指针紧接着就做一次空指针校验形成获取即校验的防御模式。后续axesSize 0的数据校验则交给OP_CHECK_IFsrc/op_common/op_host/infershape_reduce_util.cpp。案例二Broadcast 类算子 Shape 推导src/op_common/op_host/infershape_broadcast_util.cpp 中的InferShape4Broadcast分别校验输入 Shape、输出 Shape并在多输入重载版本inputNum版本中于循环内对每个输入 Shape 依次校验std::vectorconst gert::Shape* inShapes(inputNum); for (size_t i 0; i inputNum; i) { auto inShape context-GetInputShape(i); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); inShapes[i] inShape; } auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape);这验证了该宏在循环体内同样安全可用do { } while (0)包裹保证了单条语句语义适合对动态数量的输入逐一校验。案例三Elewise 算子 Tiling 平台信息获取tiling 场景src/op_common/atvoss/elewise/elewise_tiling.cpp 中的ElewiseBaseTiling::GetPlatformInfoge::graphStatus ElewiseBaseTiling::GetPlatformInfo() { auto platformInfo context_-GetPlatformInfo(); OP_CHECK_NULL_WITH_CONTEXT(context_, platformInfo); auto ascendcPlatform platform_ascendc::PlatformAscendC(platformInfo); coreNum ascendcPlatform.GetCoreNumAiv(); uint64_t ubSizePlatForm 0; ascendcPlatform.GetCoreMemSize(platform_ascendc::CoreMemType::UB, ubSizePlatForm); ubSize ubSizePlatForm; return ge::GRAPH_SUCCESS; }此处校验的是GetPlatformInfo()返回的平台信息指针。若其为空后续构造PlatformAscendC并查询 AIV 核数与 UB 内存大小将全部失效因此必须先经宏防护。同样的模式还出现在 src/op_common/atvoss/reduce/reduce_tiling.cpp 以及 pkg_inc/op_common/atvoss/broadcast/broadcast_tiling.h、pkg_inc/op_common/atvoss/elewise/elewise_tiling.h、pkg_inc/op_common/atvoss/reduce/reduce_tiling.h 等公开头文件的声明中说明该宏已被广播、逐元素、归约三大类算子的 Tiling 基类广泛采用。调用示例以下示例取自官方文档仅供参考不支持直接拷贝运行auto inShape context-GetInputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); auto axesTensor context-GetInputTensor(1); OP_CHECK_NULL_WITH_CONTEXT(context, axesTensor); auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape);将其置于返回类型为ge::graphStatus的函数中即可获得完整语义任一指针为空时日志输出形如[xxx.cpp:26][OPS_BASE][InferShape4Reduce][12345] OpName:[Reduce] inShape is nullptr!随后函数返回ge::GRAPH_FAILED。最佳实践与注意事项获取即校验从 context 取出的每个指针都应紧随其后校验避免指针在中间被传递、拷贝后丢失出处也便于日志中的变量名直接指向问题代码行注意返回值类型由于宏内含return只能在返回ge::graphStatus的函数中调用若需要在无法直接返回的函数中复用逻辑可改用OP_CHECK_IF搭配自定义return_expr日志自描述利用#ptr的字符串化能力命名指针变量时使用有意义的名称如inShape、axesTensor、platformInfo日志无需额外注释即可自解释组合使用空指针校验用OP_CHECK_NULL_WITH_CONTEXT范围/取值/类型校验用OP_CHECK_IF两者搭配可形成完整的 Host 侧参数防线参考 src/op_common/op_host/infershape_reduce_util.cpp 的编排方式头文件包含使用前需包含 include/op_common/log/log.h公开路径为op_common/log/log.h并确保编译环境依赖 GE 的graph/error_codes.h提供的ge::GRAPH_FAILED。延伸阅读OP_CHECK_IF 文档条件校验宏与本文宏配合使用log 模块索引OP_LOGE / OP_LOGD / OP_LOGI / OP_LOGW 及全套OP_LOGE_FOR_*错误码日志宏清单OP_CHECK_NULL_WITH_CONTEXT 中文文档本宏的中文版说明宏定义源头include/op_common/log/log.h使用示例infershape_reduce_util.cpp、infershape_broadcast_util.cpp、elewise_tiling.cpp。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
CANN opbase 算子空指针校验指南：OP_CHECK_NULL_WITH_CONTEXT 宏详解与应用
CANN opbase 算子空指针校验指南OP_CHECK_NULL_WITH_CONTEXT 宏详解与应用【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbaseOP_CHECK_NULL_WITH_CONTEXT 是 CANN opbase算子库基础框架在 include/op_common/log/log.h 中提供的空指针校验宏用于在算子 Shape 推导InferShape与 Tiling 计算等 Host 侧流程中基于上下文快速校验指针合法性并完成日志输出与错误返回。读完本文你将掌握该宏的函数原型、参数语义、底层实现原理以及它在 infershape 与 tiling 场景中的真实用法与最佳实践。功能说明在算子 Host 侧实现中InferShapeContext、TilingParseContext、TilingContext等上下文对象会通过GetInputShape()、GetInputTensor()、GetOutputShape()、GetAttrs()、GetPlatformInfo()等接口返回指向 Shape、Tensor、Attr 或平台信息的指针。这些指针可能为空例如算子描述缺失、输入配置异常若未加保护直接解引用会导致程序崩溃。OP_CHECK_NULL_WITH_CONTEXT 的作用就是根据传入的 context 上下文校验传入的指针ptr是否为nullptr。一旦发现空指针宏会自动以该算子节点名称为标识输出一条 ERROR 级别日志并立即从当前函数返回ge::GRAPH_FAILED从而将异常情况以图执行失败的形式安全上报而非触发未定义行为。该宏定义在 include/op_common/log/log.h 中属于 opbase 为算子/算子库开发者提供的公共校验与日志基础设施与OP_CHECK_IF、OP_LOGE等接口共同构成 Host 侧健壮性防护体系。函数原型OP_CHECK_NULL_WITH_CONTEXT(context, ptr)宏的声明位于 include/op_common/log/log.h其实际展开形式如下#define OP_CHECK_NULL_WITH_CONTEXT(context, ptr) \ do { \ if (unlikely((ptr) nullptr)) { \ const char* name_ (unlikely(((context) nullptr) || (context)-GetNodeName() nullptr)) ? \ nil : \ (context)-GetNodeName(); \ OP_LOGE(name_, %s is nullptr!, #ptr); \ return ge::GRAPH_FAILED; \ } \ } while (0)注意宏体通过do { ... } while (0)包裹可安全嵌入if/else分支而无悬挂 else 问题。参数说明参数名输入/输出说明context输入传入的上下文信息类型为InferShapeContext/TilingParseContext/TilingContext用于提供算子节点名称GetNodeName()作为日志标识。ptr输入待判定的指针可为const gert::Shape*、const gert::Tensor*、const gert::Attrs*、const platform_ascendc::PlatformInfo*等任意指针类型。从实现看context 实际只依赖两个能力一是可被 nullptr比较二是提供GetNodeName()方法返回const char*或可转换为字符串的类型。因此任何具备这两个接口的上下文对象都可传入官方支持的类型即文档所列的三种上下文。返回值说明当输入ptr为nullptr时宏执行return ge::GRAPH_FAILED;即以当前函数返回值的形式向上层报告图执行失败当ptr非空时宏不产生任何副作用函数继续向下执行最终正常返回ge::GRAPH_SUCCESS。ge::GRAPH_FAILED与ge::GRAPH_SUCCESS均来自graph/error_codes.h见 include/op_common/log/log.h 的包含关系是 GEGraph Engine图执行框架的标准返回码。约束说明官方文档声明无约束。但从宏实现可以推断出两条使用前提需要开发者留意只能在返回类型为ge::graphStatus或可隐式返回该枚举值的兼容类型的函数中使用。因为宏体内部直接执行return ge::GRAPH_FAILED;若所在函数返回void或其它类型将导致编译错误。仓库中的使用点如InferShape4Reduce、InferShape4Broadcast、ElewiseBaseTiling::GetPlatformInfo返回值均为ge::graphStatus与宏完全匹配宏定义位于#ifndef OP_LOG_LIBOPAPI_ONLY条件编译块内include/op_common/log/log.h即仅在非仅 libopapi模式下可用。使用前需确保编译环境未定义OP_LOG_LIBOPAPI_ONLY。宏的底层实现剖析逐行解读 include/op_common/log/log.h 中的实现可以看到四个关键设计1.unlikely分支预测提示if (unlikely((ptr) nullptr)) {unlikely定义在 include/op_common/log/log.h#define unlikely(x) __builtin_expect((x), 0) #define likely(x) __builtin_expect((x), 1)它借助 GCC/Clang 的__builtin_expect向编译器提示指针为空是小概率路径从而优化分支布局减少正常路径的分支代价。空指针校验是防御性检查正常情况下不会触发使用unlikely契合其语义。2. 上下文与节点名的空安全处理const char* name_ (unlikely(((context) nullptr) || (context)-GetNodeName() nullptr)) ? nil : (context)-GetNodeName();宏对 context 本身也做了空判断若 context 为空或GetNodeName()返回空指针则日志中的算子名称统一回退为字符串nil保证日志输出函数不会收到空指针而二次崩溃。这与 include/op_common/log/log.h 中GetOpInfo对nullptr的nil兜底策略一致。3. 日志输出与变量名内省OP_LOGE(name_, %s is nullptr!, #ptr);#ptr是预处理器的字符串化stringification操作符将传入的变量名本身转成字符串写入日志。例如传入inShape日志即输出inShape is nullptr!无需开发者手写变量名日志天然可读、可定位。OP_LOGE的定义见 include/op_common/log/log.h它会调用OP_LOGE_LIBOPAPI_REPORT记录 ERROR 级别日志并调用REPORT_INNER_ERR_MSG(EZ9999, ...)上报内部错误消息。日志记录的格式由OP_LOGE_LIBOPAPI_REPORT决定include/op_common/log/log.h[%s:%d][%s][%s][%lu] OpName:[%s] message // 即 [文件:行号][子模块OPS_BASE][函数名][线程ID] OpName:[节点名] message其中线程 ID 通过syscall(__NR_gettid)获取见 include/op_common/log/log.h模块 ID 固定为OP_MODULE_ID 63include/op_common/log/log.h。日志是否真正落盘还取决于CheckLogLevel(OP_MODULE_ID, DLOG_ERROR)的返回DLOG_ERROR等日志级别定义在 include/op_common/log/log.h。4. 失败即返回return ge::GRAPH_FAILED;校验失败立即返回配合do { } while (0)结构使宏在调用点表现为一条语句 一次提前返回语义清晰且不会影响后续代码的 else 分支。与 OP_CHECK_IF 等配套宏的组合使用OP_CHECK_NULL_WITH_CONTEXT 只负责指针是否为空这一种检查。对于更复杂的条件校验opbase 还提供了OP_CHECK_IF宏定义于 include/op_common/log/log.h#define OP_CHECK_IF(condition, log, return_expr) \ do { \ if (unlikely(condition)) { \ log; \ return_expr; \ } \ } while (0)其官方文档见 docs/en/api/op_common/math/OP_CHECK_IF.md当条件为真时输出日志并执行return表达式。两者的分工典型如下先以OP_CHECK_NULL_WITH_CONTEXT保证指针可用再用OP_CHECK_IF校验业务条件如 shape 维度、数据类型、元素个数是否合法。在 src/op_common/op_host/infershape_reduce_util.cpp 的InferShape4Reduce中可以看到这种组合的完整形态。仓库中的真实应用案例opbase 仓库中大量 Host 侧公共实现使用该宏做入口防护以下三个案例覆盖了它最主要的两种应用场景Shape 推导与 Tiling。案例一Reduce 类算子 Shape 推导infershape 场景src/op_common/op_host/infershape_reduce_util.cpp 中的InferShape4Reducege::graphStatus InferShape4Reduce(gert::InferShapeContext* context) { auto inShape context-GetInputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); auto axesTensor context-GetInputTensor(1); OP_CHECK_NULL_WITH_CONTEXT(context, axesTensor); auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape); auto attrs context-GetAttrs(); OP_CHECK_NULL_WITH_CONTEXT(context, attrs); const bool* keepDims attrs-GetAttrPointerbool(0); OP_CHECK_NULL_WITH_CONTEXT(context, keepDims); ... }这段代码正是 docs/en/api/op_common/log/OP_CHECK_NULL_WITH_CONTEXT.md 中调用示例的原型出处。它展示了该宏的典型书写习惯每获取一个指针紧接着就做一次空指针校验形成获取即校验的防御模式。后续axesSize 0的数据校验则交给OP_CHECK_IFsrc/op_common/op_host/infershape_reduce_util.cpp。案例二Broadcast 类算子 Shape 推导src/op_common/op_host/infershape_broadcast_util.cpp 中的InferShape4Broadcast分别校验输入 Shape、输出 Shape并在多输入重载版本inputNum版本中于循环内对每个输入 Shape 依次校验std::vectorconst gert::Shape* inShapes(inputNum); for (size_t i 0; i inputNum; i) { auto inShape context-GetInputShape(i); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); inShapes[i] inShape; } auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape);这验证了该宏在循环体内同样安全可用do { } while (0)包裹保证了单条语句语义适合对动态数量的输入逐一校验。案例三Elewise 算子 Tiling 平台信息获取tiling 场景src/op_common/atvoss/elewise/elewise_tiling.cpp 中的ElewiseBaseTiling::GetPlatformInfoge::graphStatus ElewiseBaseTiling::GetPlatformInfo() { auto platformInfo context_-GetPlatformInfo(); OP_CHECK_NULL_WITH_CONTEXT(context_, platformInfo); auto ascendcPlatform platform_ascendc::PlatformAscendC(platformInfo); coreNum ascendcPlatform.GetCoreNumAiv(); uint64_t ubSizePlatForm 0; ascendcPlatform.GetCoreMemSize(platform_ascendc::CoreMemType::UB, ubSizePlatForm); ubSize ubSizePlatForm; return ge::GRAPH_SUCCESS; }此处校验的是GetPlatformInfo()返回的平台信息指针。若其为空后续构造PlatformAscendC并查询 AIV 核数与 UB 内存大小将全部失效因此必须先经宏防护。同样的模式还出现在 src/op_common/atvoss/reduce/reduce_tiling.cpp 以及 pkg_inc/op_common/atvoss/broadcast/broadcast_tiling.h、pkg_inc/op_common/atvoss/elewise/elewise_tiling.h、pkg_inc/op_common/atvoss/reduce/reduce_tiling.h 等公开头文件的声明中说明该宏已被广播、逐元素、归约三大类算子的 Tiling 基类广泛采用。调用示例以下示例取自官方文档仅供参考不支持直接拷贝运行auto inShape context-GetInputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, inShape); auto axesTensor context-GetInputTensor(1); OP_CHECK_NULL_WITH_CONTEXT(context, axesTensor); auto outShape context-GetOutputShape(0); OP_CHECK_NULL_WITH_CONTEXT(context, outShape);将其置于返回类型为ge::graphStatus的函数中即可获得完整语义任一指针为空时日志输出形如[xxx.cpp:26][OPS_BASE][InferShape4Reduce][12345] OpName:[Reduce] inShape is nullptr!随后函数返回ge::GRAPH_FAILED。最佳实践与注意事项获取即校验从 context 取出的每个指针都应紧随其后校验避免指针在中间被传递、拷贝后丢失出处也便于日志中的变量名直接指向问题代码行注意返回值类型由于宏内含return只能在返回ge::graphStatus的函数中调用若需要在无法直接返回的函数中复用逻辑可改用OP_CHECK_IF搭配自定义return_expr日志自描述利用#ptr的字符串化能力命名指针变量时使用有意义的名称如inShape、axesTensor、platformInfo日志无需额外注释即可自解释组合使用空指针校验用OP_CHECK_NULL_WITH_CONTEXT范围/取值/类型校验用OP_CHECK_IF两者搭配可形成完整的 Host 侧参数防线参考 src/op_common/op_host/infershape_reduce_util.cpp 的编排方式头文件包含使用前需包含 include/op_common/log/log.h公开路径为op_common/log/log.h并确保编译环境依赖 GE 的graph/error_codes.h提供的ge::GRAPH_FAILED。延伸阅读OP_CHECK_IF 文档条件校验宏与本文宏配合使用log 模块索引OP_LOGE / OP_LOGD / OP_LOGI / OP_LOGW 及全套OP_LOGE_FOR_*错误码日志宏清单OP_CHECK_NULL_WITH_CONTEXT 中文文档本宏的中文版说明宏定义源头include/op_common/log/log.h使用示例infershape_reduce_util.cpp、infershape_broadcast_util.cpp、elewise_tiling.cpp。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
