简介面向在 Linux 环境中使用 Python 通过 pyrfc 调用 SAP RFC 接口的开发者这份下载资源提供 SAP NW RFC SDK 的 nwrfc750P_5-70002752 版本解决 Python 程序与 SAP NetWeaver 系统通信时缺少底层 C 库的问题。压缩包共 27 个文件、约 18.05 MB主要包含头文件.h、C/C 源码.c/.cpp、动态库.so、配置文件.ini/.txt以及 rfcexec、startrfc 等可执行工具并划分 bin、include、lib、demo、doc 等目录便于按需检索。目前已有 1384 人学习下载适合企业 SAP 集成、自动化脚本开发及接口调试人员使用。对于常在 Linux 服务器上搭建 SAP 连接环境的技术人员可直接基于 SDK 完成安装配置再通过 pyrfc 封装好的 Python 接口进行连接参数管理、RFC 函数调用、ABAP 数据读取与工作流触发等操作示例中的 STFC_CONNECTION 也有助于快速验证连通性。 前阵子项目上遇到一个对接需求要在Linux服务器上用Python脚本调SAP里的RFC函数把这套联调跑通的过程记录下来。如果你也正卡在pyrfc装不上、SDK版本不匹配或者连接报错这类问题上这篇内容应该能帮你少踩几个坑。先交代下背景SAP系统对外提供数据交互最常用的方式就是RFCRemote Function Call而Python要调RFC函数社区里最成熟的选择就是pyrfc这个库。pyrfc本身不是纯Python实现它底层依赖SAP官方的NWRFC SDK所以整套环境的搭建其实分两部分一是把NWRFC SDK装好二是让pyrfc能正确找到并加载这个SDK。整个过程在Linux上比Windows稍微麻烦一点主要麻烦在依赖库和路径配置上。需要这套环境的人一般是做SAP外围系统集成的开发或运维比如从SAP拉取物料主数据、同步订单状态、调用BAPI做业务操作这类场景。下面从环境准备到代码调用把完整链路拆开讲。1. 整体方案设计为什么必须有NWRFC SDK1.1 理解pyrfc和NWRFC SDK的关系pyrfc是SAP官方维护的Python连接器但它的定位是SDK的Python绑定层。真正的通信逻辑、RFC协议解析、连接管理、数据序列化全部在NWRFC SDK的C/C动态库里实现。打个比方pyrfc像方向盘和仪表盘NWRFC SDK才是底盘和发动机。所以在Linux上部署pyrfc本质上是两件事装好SDK并让它能被程序找到再装pyrfc的Python包。很多人卡在安装环节就是因为只安装了pyrfc不知道还需要单独准备SDK或者SDK版本跟pyrfc要求的对不上。1.2 SDK版本选择和平台匹配SAP的NWRFC SDK可以从SAP官方开发者网站下载文件名类似nwrfc750X_X-70002753.tgz这类格式。需要注意两点版本号SDK版本对应SAP NetWeaver版本7.50、7.51、7.53等。建议选择较新的版本因为旧版本可能存在已知Bug而且新版本向后兼容性更好。平台和架构Linux下要区分x86_64和ARM64比如树莓派或部分国产服务器选错了加载时会直接报错没有任何商量余地。提示下载SDK需要SAP的账号权限通常会要求你同意一个开发者许可协议。这不是随便能绕过的合规上要走正规渠道。1.3 架构上为什么不用其他方案有些朋友可能会问为什么不直接用SAP的RESTful API或者OData接口这不是抬杠而是不同场景的取舍。RFC是老牌SAP系统最通用、最稳定的交互方式很多BAPI和自定义函数只暴露RFC接口没有HTTP封装。此外pyrfc在处理大数据量批量传输时性能和稳定性明显优于OData轮询。如果你的需求是高频、大批量、事务性操作pyrfc配合NWRFC SDK是更合理的选择。2. 核心细节解析依赖项、环境变量与安装流程2.1 Linux系统的依赖库准备在Ubuntu或Debian系系统上需要先安装一些基础依赖否则SDK里的动态库加载不了sudo apt update sudo apt install -y build-essential libssl-dev libsapnwrfc-dev注意libsapnwrfc-dev在某些系统源里可能没有需要手动安装SDK后自行配置。不要因为这一步报错就慌了后面会讲到手动配置方式。如果是CentOS/RHEL系用yum或dnfsudo yum install -y gcc gcc-c make openssl-devel2.2 SDK解压与目录规划将下载的SDK解压到统一目录建议放在/opt/sap/nwrfcsdk方便管理和后续环境变量配置。解压后目录结构大致如下/opt/sap/nwrfcsdk/ ├── lib/ └── include/其中lib下存放的是核心动态库文件比如libsapnwrfc.soinclude下是头文件编译时用得到。我没有把SDK放到/usr/local而是放在/opt/sap下原因是方便区分——这个目录只服务于SAP相关组件后续升级SDK版本直接替换这个目录就行不用担心影响其他程序。2.3 环境变量配置的细节pyrfc在运行时需要找到SDK的动态库这里关键环境变量有两个SAPNWRFC_HOME和LD_LIBRARY_PATH或者LD_LIBRARY_PATH_64取决于内核架构。编辑/etc/profile或用户级~/.bashrcexport SAPNWRFC_HOME/opt/sap/nwrfcsdk export LD_LIBRARY_PATH$SAPNWRFC_HOME/lib:$LD_LIBRARY_PATH然后执行source ~/.bashrc之所以要设置SAPNWRFC_HOME是因为pyrfc在安装时和运行时都会使用这个变量来定位SDK。如果这个变量缺失即使LD_LIBRARY_PATH配好了安装也可能报“SDK not found”的错误。2.4 验证SDK是否可用在正式装pyrfc之前最好先验证一下SDK的动态库能否被系统正常加载ldconfig -p | grep sapnwrfc如果没有任何输出说明SDK的lib目录还没被系统识别可以手动让ldconfig缓存刷新sudo ldconfig /opt/sap/nwrfcsdk/lib这一步处理好后面就顺手很多。3. 实操过程从pip安装pyrfc到第一个RFC调用3.1 安装pyrfc在SDK配置完成后安装pyrfc会顺畅很多。建议在虚拟环境里操作避免污染系统Pythonpython3 -m venv sap_env source sap_env/bin/activate pip install pyrfc实测下来如果环境变量配置正确pip会直接下载对应的wheel包不需要本地编译。如果pip找不到匹配的wheel或者你用的是源码安装则需要本地编译此时必须确保Python开发头文件已安装sudo apt install -y python3-dev编译安装的话pip install --no-binary pyrfc pyrfc这个过程会调用C编译器所以前面提到的build-essential必须装好。3.2 第一个连接配置连接参数详解连接SAP需要一组连接参数。标准的配置类似下面这样import pyrfc conn pyrfc.Connection( userRFC_USER, passwdyour_password, ashost10.10.10.10, sysnr00, client100, langZH )各参数含义ashostSAP应用服务器地址sysnr系统编号通常是两位数字client客户端编号三位数字lang登录语言ZH是中文EN是英文如果SAP系统启用了负载均衡用mshost、group等参数替代ashost。注意密码中如果包含特殊字符建议使用环境变量或配置文件传入避免写死在代码里。3.3 调用RFC函数的基础模式连接建立后调用RFC函数的方式非常直接。例如调用RFC_PING测试连通性result conn.call(RFC_PING) print(Ping OK:, result)返回是一个空的字典但只要能正常返回就说明连通性没问题。更实际的场景调用获取系统信息的RFC_SYSTEM_INFOsys_info conn.call(RFC_SYSTEM_INFO) print(SAP Release:, sys_info.get(RFCPROTO))这种简单的调用适合快速验证环境是否完全OK。3.4 带导入导出参数的完整调用示例SAP的RFC函数往往有导入参数、导出参数和表参数。比如调用某个BAPI查询物料信息通常需要传一个输入参数然后从返回结果里取表格数据。以BAPI_MATERIAL_GETLIST为例result conn.call( BAPI_MATERIAL_GETLIST, MAXROWS10, MATERIAL_TYPEFERT ) # 返回结果是一个字典包含了表参数 materials result.get(MATERIAL_LIST, []) for mat in materials: print(mat[MATERIAL], mat[MATL_DESC])关键点在于pyrfc把RFC函数的导入参数、导出参数、表参数统一映射成了Python字典的键。你不需要关心底层ABAP数据类型怎么对应pyrfc会自动完成序列化和反序列化。3.5 批量调用与性能优化实际业务中逐条调用BAPI会非常慢推荐方式是在一个会话里批量处理。可以用循环但要注意尽量复用同一个连接对象避免频繁建连、断连如果涉及事务性操作可以在业务侧调用BAPI_TRANSACTION_COMMIT提交数据量大的场景考虑分批拉取避免SAP侧内存暴掉一个简单的批量示例material_codes [A001, A002, A003] conn pyrfc.Connection(...) for code in material_codes: result conn.call(BAPI_MATERIAL_GET_DETAIL, MATERIALcode) # 处理result如果你的RFC函数支持传表作为输入优先用一次传全部、一次返回全部的方式而不是循环调用。这样网络往返次数大幅减少性能能提升一个数量级。3.6 连接池的必要性对于Web服务或常驻进程每次请求都新建连接的开销不可忽略。SAP侧也会对并发连接数有限制如果短时间建连太频繁可能被SAP锁定。推荐用连接池管理from pyrfc import Connection import threading class SAPPool: def __init__(self, max_connections5, **conn_params): self._params conn_params self._pool [] self._lock threading.Lock() def get_conn(self): with self._lock: if not self._pool: return Connection(**self._params) return self._pool.pop() def return_conn(self, conn): with self._lock: self._pool.append(conn)这只是最简版本生产环境还需要考虑连接失效后的重连、连接健康检查等。不过有了这个思路就不会在并发稍高时被打垮。4. 常见问题与排查技巧实录4.1 ImportError: libsapnwrfc.so: cannot open shared object file这是装完pyrfc后最常见的报错原因基本可以锁定为动态库路径未找到。排查思路ldd $(python -c import pyrfc; print(pyrfc.__file__))看输出中是否有哪一行显示libsapnwrfc.so not found。如果确认not found说明LD_LIBRARY_PATH没生效或者配置错了位置。重新检查环境变量并确认source过了。如果环境变量没问题还有一种可能是SDK的动态库本身有依赖缺失可以用ldd /opt/sap/nwrfcsdk/lib/libsapnwrfc.so查看SDK自身的依赖是否完整。4.2 SAPNWRFC_HOME is not set or invalid安装pyrfc或运行时出现这个提示说明SDK路径没找到。检查两点环境变量是否设置正确、目录是否存在。有些场景下你设置了环境变量但pip安装时还是报错可以尝试显式传入SAPNWRFC_HOME/opt/sap/nwrfcsdk pip install pyrfc这种方式在CI/CD流水线里尤其好用。4.3 RFC连接超时或报错“connection refused”通常意味着网络层面不通或者SAP侧对应的服务端口没监听。先用telnet或nc验证nc -zv 10.10.10.10 3300SAP的RFC默认端口通常是33sysnr比如系统编号是00则端口是3300系统编号是01则端口是3301。如果端口不通优先排查防火墙、SAP网关服务和SAP路由权限。4.4 报错“name not resolved”或“hostname unknown”这个比较隐蔽一般发生在使用mshost连接的时候。SAP的消息服务器要求客户端能反向解析SAP服务器的主机名否则报错。解决办法是在/etc/hosts里加上SAP服务器的记录10.10.10.10 sapapp014.5 Python版本兼容性问题pyrfc对Python版本有支持范围某些旧版本不支持Python 3.11以上版本。装之前先确认SAP官方文档里的支持矩阵或者直接看pip的元数据pip show pyrfc如果发现pyrfc版本过旧建议先升级pyrfc再排查其他问题。4.6 常见问题速查表报错信息可能原因处理方式libsapnwrfc.so not foundLD_LIBRARY_PATH未设置配置环境变量并ldconfigSAPNWRFC_HOME is not setSDK路径变量缺失设置SAPNWRFC_HOMEconnection refused网络不通或端口不对telnet验证端口检查防火墙name not resolved主机名解析失败配置/etc/hostsRFC function not found函数名拼写错误或权限不够检查调用权限和函数名大小写data type conversion error参数类型不匹配核对RFC函数签名和参数类型4.7 排查技巧开启pyrfc的调试日志如果遇到比较诡异的问题普通报错信息看不出名堂可以开启pyrfc的详细日志import logging logging.basicConfig(levellogging.DEBUG)或者设置环境变量export RFC_TRACE3这样pyrfc会输出底层RFC通信的追踪信息包括协议包、调用细节等对定位问题帮助极大。不过要注意RFC_TRACE3会输出非常多的信息生产环境不要轻易开启。5. 更进一步把这套环境落地到生产环境5.1 容器化部署的注意事项很多朋友现在更倾向于把环境打包成Docker镜像。用Docker部署时SDK目录和环境变量需要在Dockerfile里处理好不能只依赖宿主机。参考Dockerfile片段FROM python:3.10-slim WORKDIR /app COPY nwrfcsdk /opt/sap/nwrfcsdk ENV SAPNWRFC_HOME/opt/sap/nwrfcsdk ENV LD_LIBRARY_PATH/opt/sap/nwrfcsdk/lib:${LD_LIBRARY_PATH} RUN apt-get update apt-get install -y libssl-dev \ pip install pyrfc COPY app.py /app/ CMD [python, /app.py]装SDK时注意libsapnwrfc.so对glibc版本有要求如果基础镜像太老比如Debian 10以下可能加载不了。建议使用较新的基础镜像比如Debian 11及以上。5.2 密钥管理不要让密码出现在代码里生产环境里SAP账号密码是敏感信息不要硬编码在Python文件里。常见的做法是用python-dotenv读取.env文件或者直接引用环境变量import os from dotenv import load_dotenv load_dotenv() conn pyrfc.Connection( useros.getenv(SAP_USER), passwdos.getenv(SAP_PASSWD), ashostos.getenv(SAP_HOST), sysnros.getenv(SAP_SYSNR), clientos.getenv(SAP_CLIENT), langZH )更进一步可以对接Vault、KMS这类密钥管理系统动态获取密码。5.3 配置项统一管理连接参数分散在多个脚本里后期维护会很痛苦。建议把配置集中到一个YAML文件里sap: ashost: 10.10.10.10 sysnr: 00 client: 100 lang: ZH user: ${SAP_USER} passwd: ${SAP_PASSWD}然后写一个公共的读取模块所有脚本共用同一个配置源后续改连接参数只需要动一处。收个尾一点个人体会从零开始搭这套环境踩得最多的坑其实不在pyrfc本身而在SDK和系统环境的配合上。很多时候报错信息看起来是pyrfc的问题实际去排查全是环境变量、依赖库、版本匹配这类基础问题。所以如果你也遇到类似情况别急着找pyrfc代码的问题先回过头来梳理环境。我个人还比较推荐的做法是先写一个最小的冒烟脚本只调用RFC_PING跑通了再往里面加业务逻辑。这样一旦出现问题可以快速定位是环境问题还是业务逻辑问题。另外每次升级pyrfc或SDK之前务必看官方发布说明特别是版本兼容性部分的更新。如果你是按这篇内容从零开始操作理论上半小时内就能完成从SDK安装到第一个RFC调用的全过程。后面如果你们也遇到什么蹊跷的连接问题或者有什么奇葩的SAP函数返回结构欢迎一起交流。本文还有配套的精品资源点击获取