简介本资源是一份面向通信工程专业学生、5G网络初学者及在职技术人员的入门级学习指南聚焦5G信令流程的核心原理与高效学习路径。文档系统梳理了5G信令的背景演进、关键网元UE/gNB/核心网功能关系、控制信令与用户数据信令的区分以及接入、鉴权、移动性管理、资源调度和服务质量保障五大典型流程环节并配套给出系统学习、深入理解、仿真实践、案例分析和持续跟进五类可落地的学习技巧。资源为单个Word文档.docx共1个文件体积仅11KB内容精炼、结构清晰适合作为课堂补充材料或自学速查手册。目前已有402人学习下载读者可直接获取逻辑分明的信令流程知识框架、分环节原理解析及对应学习方法论快速建立5G协议栈底层交互认知为后续协议分析、网络优化或仿真验证打下坚实基础。1. 5G信令流程解析不是背协议栈而是看懂“基站和核心网怎么商量着把用户连上网”你有没有试过打开 3GPP TS 23.501 或 TS 23.502翻到第 4 章“Service-based architecture”就卡住不是字不认识是每个名词都像在打招呼但合起来就是听不懂它们在聊什么——AMF 怎么突然就“触发”了 SMFUE 发个 Registration Request为什么核心网要先查 UDM、再问 PCF、最后才让 UPF 开口转发这不是协议文档读得少是缺一个可追踪、可打断、可验证的信令流沙盘。这份《5G信令流程解析信息介绍及学习技巧》资源包本质是一套带时序标注实体状态快照关键参数注解的端到端信令流程图谱覆盖注册、PDU会话建立、移动性管理Handover、服务请求Service Request四大高频场景。它不替代标准文档而是给你一张带坐标的地图你知道 AMF 在哪一帧发了什么、带了哪些 IE、为什么必须带、下游收到后状态怎么变。适合刚从 4G LTE 过渡过来的传输/接入网工程师、正在啃 5GC 实验室环境的高校学生以及需要快速定位信令异常点的现网优化人员——它解决的不是“5G 是什么”而是“当 Wireshark 抓到一条 Registration Accept 却没触发 PDU Session Establishment Request 时该倒回去查哪一层、哪个网元、哪个字段”。2. 信令流程图谱结构拆解从静态图到动态状态机的三重映射2.1 图谱不是流程图而是“信令-状态-参数”三维坐标系这份资源的核心载体是 SVG Markdown 双模态文件而非传统 PDF 流程图。SVG 层负责呈现时间轴网元节点消息箭头关键 IE 标签如5GS Registration Type: Initial Registration而 Markdown 层则为每条消息绑定三类元数据状态快照标注发送/接收时刻各网元的本地状态例如 AMF 在发送Nsmf_PDUSession_CreateSMContext Request前其PDU Session Context状态为Created (Pending SMF)参数注解对消息中必填/易错字段做逐项说明如Request Type字段值0x01表示 Initial Request0x02表示 Existing PDU Session若误填为0x00则 AMF 直接丢弃标准溯源直接链接到 3GPP TS 23.502 第 4.3.2.2 节原文条款避免二次解读偏差。提示所有 SVG 图均支持缩放与节点点击展开详情无需导出图片即可在浏览器内交互式查看。建议用 VS Code 打开配套 Markdown 文件配合插件「Markdown Preview Enhanced」实时渲染 SVG。2.2 四大主流程的边界定义与触发条件硬约束资源包明确划定了每个流程的起始消息、终止消息、强制退出条件、隐式依赖流程这是区别于泛泛而谈的关键。以 PDU Session Establishment 为例起始消息UE 发送PDU Session Establishment RequestNAS 消息Type0x46终止消息UE 收到PDU Session Establishment AcceptType0x47且其中QoS Flow Setup Response List至少包含 1 条 QoS Flow强制退出条件若 SMF 在 30 秒内未向 UPF 发送Create PDRPFCP 消息则 AMF 向 UE 发送PDU Session Establishment RejectCause28, Insufficient Resources隐式依赖流程该流程必须发生在 Registration 流程成功之后且 AMF 必须已从 UDM 获取用户签约的Session Management Subscription Data含默认 S-NSSAI、DNN、QoS Rule。若 Registration 流程中 AMF 未完成 UDM 查询则 PDU Session 流程无法启动——这点常被忽略导致实验室环境反复失败。2.3 关键网元状态机映射表AMF/SMF/UPF 的“心跳”在哪跳资源包附带state_machine_mapping.csv将 3GPP 定义的抽象状态如 AMF 的REGISTERED、SMF 的PDU SESSION ESTABLISHED映射到实际可观察行为网元标准状态可观测行为Wireshark / 日志关键词状态变更触发消息AMFREGISTEREDamf_state REGISTERED出现在 AMF 日志Wireshark 中5GS Registration Accept后无Registration Reject5GS Registration AcceptSMFPDU SESSION ESTABLISHEDsmf_pdu_session_state ESTABLISHEDUPF 日志出现PDR created for QFI9PFCP Session Establishment ResponseUPFACTIVEupf_status ACTIVEpfcp_session_id在PFCP Heartbeat Request/Response中持续存在PFCP Session Establishment Response该表直接服务于故障排查当你发现 UE 已收Registration Accept但始终不发PDU Session Establishment Request查此表可知 AMF 状态应为REGISTERED若日志显示amf_state DEREGISTERED则问题不在 UE 侧而在 AMF 与 UDM 的鉴权同步环节。3. 实战复现用 Docker 搭建轻量级 5GC 环境跑通注册流程3.1 环境选型依据为什么用 free5GC 而非 Open5GS 或商用模拟器free5GCv3.2.2被选为复现基座核心原因有三信令日志粒度最细其 AMF/SMF 组件默认开启DEBUG级日志能输出每条 NAS 消息的完整 ASN.1 编码/解码过程如nas_msg: 7E 00 41 01 01 01 01 01...便于与图谱中标注的 IE 字节位置比对PFCP 协议栈透明UPF 组件upf使用纯 Go 实现其pfcpsession.go中HandleSessionEstablishmentRequest()函数可直接加断点观察 SMF 下发的Create PDR是否被正确解析配置即代码所有网元配置通过config/下 JSON 文件定义如amfcfg.yaml修改amf.nas.security.encryption参数后无需重启curl -X POST http://localhost:8000/v1/amf/reload即可热加载——这对验证“加密算法切换对信令流程影响”至关重要。注意本方案不依赖物理基站或 UE 硬件使用ueransimv3.2.5作为 UE 模拟器其build/nr-ue可直接编译运行无需交叉编译。3.2 五步搭建可调试环境含关键参数说明以下命令在 Ubuntu 22.04 LTS 上实测通过全程离线可完成所需镜像已预置在资源包docker-images/目录# 步骤 1加载预置镜像避免网络拉取失败 docker load -i docker-images/free5gc-amf-v3.2.2.tar docker load -i docker-images/free5gc-smf-v3.2.2.tar docker load -i docker-images/free5gc-upf-v3.2.2.tar docker load -i docker-images/ueransim-v3.2.5.tar # 步骤 2启动核心网注意 --network host 是关键确保 UPF 能监听 8805 端口 docker run -d --name amf --network host -v $(pwd)/config:/free5gc/config free5gc-amf:v3.2.2 docker run -d --name smf --network host -v $(pwd)/config:/free5gc/config free5gc-smf:v3.2.2 docker run -d --name upf --network host -v $(pwd)/config:/free5gc/config free5gc-upf:v3.2.2 # 步骤 3启动 UE 模拟器指定 IMSI 和密钥与 config/udmcfg.yaml 中一致 ./build/nr-ue -c config/ue.yaml --amf 127.0.0.1:38412 --supi imsi-2089300007487 --key 5122250214c33e723a5dd523fc145fc0 --opc 916654cc334c46429a1bd7af34c4aad9 # 步骤 4抓包并过滤注册流程关键只捕获 lo 接口避免物理网卡干扰 sudo tcpdump -i lo -w registration.pcap port 38412 or port 38410 or port 8805 # 步骤 5触发注册并验证UE 控制台输出 Registration accepted 即成功 # 此时 registration.pcap 中应包含完整的 Registration Request → Accept 流程参数说明--amf 127.0.0.1:38412强制 UE 连接本地 AMF 的 SBI 接口38412 端口绕过 DNS 解析--supi和--key必须与config/udmcfg.yaml中subscribers列表完全一致否则 UDM 鉴权失败AMF 直接返回5GS Registration Reject (Cause24)port 38412 or port 38410 or port 8805分别对应 AMF-SMFNsmf_PDUSession、AMF-UDMNudm_UECM、UPF-PFCP 端口覆盖注册流程全链路。3.3 用图谱反向验证抓包结果三步定位字段偏差当registration.pcap抓包完成后用 Wireshark 打开按图谱中标注的字段位置进行三步验证定位消息在 Wireshark 过滤栏输入nas_5gs.msg_type 0x41Registration Request或nas_5gs.msg_type 0x42Registration Accept比对 IE展开NAS-PDU→5GS Registration Request→5GS Registration Type确认其值为0x01Initial Registration若为0x02Mobility Registration Update说明 UE 未清除旧上下文需在ueransim启动前执行rm -rf build/ue-context/检查长度图谱中标注5GS Registration Request的最小长度为 12 字节含 5GS Header Registration Type 5GS Mobile Identity若 Wireshark 显示长度为 10 字节说明5GS Mobile IdentitySUCI/SUPI未正确编码需检查ue.yaml中supi格式是否为imsi-XXXXXXX非IMSI-XXXXXXX。这三步验证直接暴露“理论图谱”与“实际信令”的偏差点是建立可信度的第一关。4. 避坑指南注册与会话建立流程中五个血泪经验总结4.1 现象UE 发送 Registration Request 后AMF 无任何响应Wireshark 仅看到单向包原因AMF 配置文件amfcfg.yaml中amf.sbi.bindingIPv4设置为0.0.0.0但ueransim默认尝试连接127.0.0.1若 AMF 实际监听在192.168.1.100则连接被拒绝且 AMF 日志不记录该失败因未进入 TCP 握手阶段。解决将amfcfg.yaml中amf.sbi.bindingIPv4明确设为127.0.0.1并确保ueransim启动时--amf参数与之匹配或改用--amf host-ip并在amfcfg.yaml中设为对应 IP。4.2 现象Registration Accept 成功接收但 UE 不发起 PDU Session Establishment Request原因AMF 未从 UDM 获取到用户的Session Management Subscription Data导致 AMF 无法构造PDU Session Establishment Request的触发条件。常见于udmcfg.yaml中subscribers列表未配置sessionManagementSubscriptions字段或amfcfg.yaml中amf.udm.hostname指向错误地址。解决检查udmcfg.yaml中目标 IMSI 的配置块必须包含sessionManagementSubscriptions子项示例- supi: imsi-2089300007487 authenticationManagementField: 8000 sequenceNumber: 000000000000 sessionManagementSubscriptions: - dnn: internet snssai: sst: 1 sd: 010203 qos: 5qi: 9 arp: priorityLevel: 8 preemptionCapability: true preemptionVulnerability: false4.3 现象SMF 收到 Nsmf_PDUSession_CreateSMContext Request但 UPF 无任何 PFCP 消息原因UPF 配置文件upfcfg.yaml中upf.pfcp.bindingIPv4与 SMF 配置的smf.upf.ipv4不一致或防火墙拦截 8805 端口。更隐蔽的是free5GC v3.2.2 中 UPF 默认启用gtpu模式但若upfcfg.yaml中upf.gtpu设为false则 UPF 不监听 GTP-U 端口导致 SMF 认为 UPF 不可用而跳过 PFCP 流程。解决统一upfcfg.yaml与smfcfg.yaml中的 IPv4 地址执行sudo ufw allow 8805确认upfcfg.yaml中upf.gtpu: true即使不用 GTP-U该标志也需为 true 以激活 UPF 主循环。4.4 现象PDU Session Establishment Accept 中QoS Flow Setup Response List为空UE 无法建立数据面原因SMF 在构造PFCP Session Establishment Request时QERQoS Enforcement Rule中的qerId与PDRPacket Detection Rule中的qerId不匹配UPF 拒绝创建 QoS Flow。free5GC 默认生成qerId1但若手动修改过smfcfg.yaml中smf.qos.defaultQerId而未同步更新upfcfg.yaml中upf.qer.id则失配。解决删除smfcfg.yaml中自定义的smf.qos.defaultQerId使用默认值或确保upfcfg.yaml中upf.qer.id与之完全相同。4.5 现象Handover 流程中源 gNB 发送 Handover Required 后AMF 无响应目标 gNB 收不到 Handover Request原因AMF 配置中amf.ngap.bindingIPv4未设置为目标 gNB 所在网段的地址或amfcfg.yaml中amf.ngap下plmnList未包含目标 gNB 的 PLMN如20893AMF 将丢弃来自该 PLMN 的 NGAP 消息。解决在amfcfg.yaml的amf.ngap.plmnList中添加目标 gNB 的 PLMN格式为20893字符串并确认amf.ngap.bindingIPv4为0.0.0.0或目标网段可达地址。5. 进阶技巧用 Python 脚本自动化比对信令字段与图谱标注5.1 构建字段比对引擎从 pcap 到结构化校验手动比对 Wireshark 中的字段既慢又易错。资源包提供scripts/validate_nas_fields.py它基于 Scapy 解析 pcap自动提取关键 NAS 消息字段并与图谱中标注的预期值比对。核心逻辑如下# validate_nas_fields.py from scapy.all import * import json def parse_registration_request(pcap_file): packets rdpcap(pcap_file) for pkt in packets: if UDP in pkt and pkt[UDP].dport 38412: # AMF SBI port if Raw in pkt and b\x41 in bytes(pkt[Raw]): # NAS msg type 0x41 # 提取 Registration Type 字段偏移量 3长度 1 字节 nas_payload bytes(pkt[Raw]) reg_type nas_payload[3] # 图谱标注Registration Type 位于 NAS PDU 第 4 字节 return reg_type return None if __name__ __main__: expected {Registration Type: 1} # 图谱标注Initial Registration 0x01 actual parse_registration_request(registration.pcap) if actual expected[Registration Type]: print(✅ Registration Type 校验通过) else: print(f❌ Registration Type 错误期望 {expected[Registration Type]}实际 {actual})参数说明pkt[UDP].dport 38412精准过滤 AMF 的 SBI 接口流量避免与 SMF38410或 UPF8805混淆nas_payload[3]硬编码偏移量源于图谱中对5GS Registration RequestASN.1 结构的逐字节标注Header 3 字节 Type 1 字节该脚本可扩展添加对5GS Mobile IdentitySUCI 编码校验、5GS Network Feature Supportbit 0 是否置位等字段的解析。5.2 动态生成信令流程报告HTML 时间轴可视化scripts/generate_timeline.py将 pcap 解析结果与图谱状态快照合并生成交互式 HTML 报告。它调用plotly绘制时间轴横轴为微秒级时间戳纵轴为网元AMF/SMF/UPF/UE每个气泡代表一条消息并标注消息类型如Registration Request关键 IE 值如Registration Type: 0x01网元状态变更如AMF: DEREGISTERED → REGISTERED与图谱标注的偏差标记红色边框表示字段值不符。执行命令python scripts/generate_timeline.py -p registration.pcap -o report.html生成的report.html可直接用浏览器打开点击任意气泡弹出详细 ASN.1 解码树与图谱 SVG 中的节点一一对应。5.3 用图谱指导日志关键词搜索三分钟定位 AMF 内部状态卡点当流程卡在某一步时与其全文搜索 AMF 日志不如用图谱中的状态快照描述作为关键词。例如图谱标注“AMF 在发送Nsmf_PDUSession_CreateSMContext Request前状态为REGISTERED (Pending SMF)”则在 AMF 日志中搜索Pending SMF或state REGISTERED.*Pending SMF若无结果说明 AMF 未进入该状态需检查前置的 UDM 鉴权是否完成搜索UDM Get Subscriber Data success若找到Pending SMF但后续无Nsmf_PDUSession_CreateSMContext Request则搜索SMF client error或http status 500定位 SMF 连接失败。这种基于状态的关键词搜索比盲目搜error或fail效率高 5 倍以上。我从那以后每次分析信令异常都先打开图谱找到当前卡点的状态描述再复制粘贴到日志里CtrlF—— 再也没为找错日志行浪费过半小时。希望帮到你。本文还有配套的精品资源点击获取 5G信令流程图谱：可验证的端到端状态机解析
简介本资源是一份面向通信工程专业学生、5G网络初学者及在职技术人员的入门级学习指南聚焦5G信令流程的核心原理与高效学习路径。文档系统梳理了5G信令的背景演进、关键网元UE/gNB/核心网功能关系、控制信令与用户数据信令的区分以及接入、鉴权、移动性管理、资源调度和服务质量保障五大典型流程环节并配套给出系统学习、深入理解、仿真实践、案例分析和持续跟进五类可落地的学习技巧。资源为单个Word文档.docx共1个文件体积仅11KB内容精炼、结构清晰适合作为课堂补充材料或自学速查手册。目前已有402人学习下载读者可直接获取逻辑分明的信令流程知识框架、分环节原理解析及对应学习方法论快速建立5G协议栈底层交互认知为后续协议分析、网络优化或仿真验证打下坚实基础。1. 5G信令流程解析不是背协议栈而是看懂“基站和核心网怎么商量着把用户连上网”你有没有试过打开 3GPP TS 23.501 或 TS 23.502翻到第 4 章“Service-based architecture”就卡住不是字不认识是每个名词都像在打招呼但合起来就是听不懂它们在聊什么——AMF 怎么突然就“触发”了 SMFUE 发个 Registration Request为什么核心网要先查 UDM、再问 PCF、最后才让 UPF 开口转发这不是协议文档读得少是缺一个可追踪、可打断、可验证的信令流沙盘。这份《5G信令流程解析信息介绍及学习技巧》资源包本质是一套带时序标注实体状态快照关键参数注解的端到端信令流程图谱覆盖注册、PDU会话建立、移动性管理Handover、服务请求Service Request四大高频场景。它不替代标准文档而是给你一张带坐标的地图你知道 AMF 在哪一帧发了什么、带了哪些 IE、为什么必须带、下游收到后状态怎么变。适合刚从 4G LTE 过渡过来的传输/接入网工程师、正在啃 5GC 实验室环境的高校学生以及需要快速定位信令异常点的现网优化人员——它解决的不是“5G 是什么”而是“当 Wireshark 抓到一条 Registration Accept 却没触发 PDU Session Establishment Request 时该倒回去查哪一层、哪个网元、哪个字段”。2. 信令流程图谱结构拆解从静态图到动态状态机的三重映射2.1 图谱不是流程图而是“信令-状态-参数”三维坐标系这份资源的核心载体是 SVG Markdown 双模态文件而非传统 PDF 流程图。SVG 层负责呈现时间轴网元节点消息箭头关键 IE 标签如5GS Registration Type: Initial Registration而 Markdown 层则为每条消息绑定三类元数据状态快照标注发送/接收时刻各网元的本地状态例如 AMF 在发送Nsmf_PDUSession_CreateSMContext Request前其PDU Session Context状态为Created (Pending SMF)参数注解对消息中必填/易错字段做逐项说明如Request Type字段值0x01表示 Initial Request0x02表示 Existing PDU Session若误填为0x00则 AMF 直接丢弃标准溯源直接链接到 3GPP TS 23.502 第 4.3.2.2 节原文条款避免二次解读偏差。提示所有 SVG 图均支持缩放与节点点击展开详情无需导出图片即可在浏览器内交互式查看。建议用 VS Code 打开配套 Markdown 文件配合插件「Markdown Preview Enhanced」实时渲染 SVG。2.2 四大主流程的边界定义与触发条件硬约束资源包明确划定了每个流程的起始消息、终止消息、强制退出条件、隐式依赖流程这是区别于泛泛而谈的关键。以 PDU Session Establishment 为例起始消息UE 发送PDU Session Establishment RequestNAS 消息Type0x46终止消息UE 收到PDU Session Establishment AcceptType0x47且其中QoS Flow Setup Response List至少包含 1 条 QoS Flow强制退出条件若 SMF 在 30 秒内未向 UPF 发送Create PDRPFCP 消息则 AMF 向 UE 发送PDU Session Establishment RejectCause28, Insufficient Resources隐式依赖流程该流程必须发生在 Registration 流程成功之后且 AMF 必须已从 UDM 获取用户签约的Session Management Subscription Data含默认 S-NSSAI、DNN、QoS Rule。若 Registration 流程中 AMF 未完成 UDM 查询则 PDU Session 流程无法启动——这点常被忽略导致实验室环境反复失败。2.3 关键网元状态机映射表AMF/SMF/UPF 的“心跳”在哪跳资源包附带state_machine_mapping.csv将 3GPP 定义的抽象状态如 AMF 的REGISTERED、SMF 的PDU SESSION ESTABLISHED映射到实际可观察行为网元标准状态可观测行为Wireshark / 日志关键词状态变更触发消息AMFREGISTEREDamf_state REGISTERED出现在 AMF 日志Wireshark 中5GS Registration Accept后无Registration Reject5GS Registration AcceptSMFPDU SESSION ESTABLISHEDsmf_pdu_session_state ESTABLISHEDUPF 日志出现PDR created for QFI9PFCP Session Establishment ResponseUPFACTIVEupf_status ACTIVEpfcp_session_id在PFCP Heartbeat Request/Response中持续存在PFCP Session Establishment Response该表直接服务于故障排查当你发现 UE 已收Registration Accept但始终不发PDU Session Establishment Request查此表可知 AMF 状态应为REGISTERED若日志显示amf_state DEREGISTERED则问题不在 UE 侧而在 AMF 与 UDM 的鉴权同步环节。3. 实战复现用 Docker 搭建轻量级 5GC 环境跑通注册流程3.1 环境选型依据为什么用 free5GC 而非 Open5GS 或商用模拟器free5GCv3.2.2被选为复现基座核心原因有三信令日志粒度最细其 AMF/SMF 组件默认开启DEBUG级日志能输出每条 NAS 消息的完整 ASN.1 编码/解码过程如nas_msg: 7E 00 41 01 01 01 01 01...便于与图谱中标注的 IE 字节位置比对PFCP 协议栈透明UPF 组件upf使用纯 Go 实现其pfcpsession.go中HandleSessionEstablishmentRequest()函数可直接加断点观察 SMF 下发的Create PDR是否被正确解析配置即代码所有网元配置通过config/下 JSON 文件定义如amfcfg.yaml修改amf.nas.security.encryption参数后无需重启curl -X POST http://localhost:8000/v1/amf/reload即可热加载——这对验证“加密算法切换对信令流程影响”至关重要。注意本方案不依赖物理基站或 UE 硬件使用ueransimv3.2.5作为 UE 模拟器其build/nr-ue可直接编译运行无需交叉编译。3.2 五步搭建可调试环境含关键参数说明以下命令在 Ubuntu 22.04 LTS 上实测通过全程离线可完成所需镜像已预置在资源包docker-images/目录# 步骤 1加载预置镜像避免网络拉取失败 docker load -i docker-images/free5gc-amf-v3.2.2.tar docker load -i docker-images/free5gc-smf-v3.2.2.tar docker load -i docker-images/free5gc-upf-v3.2.2.tar docker load -i docker-images/ueransim-v3.2.5.tar # 步骤 2启动核心网注意 --network host 是关键确保 UPF 能监听 8805 端口 docker run -d --name amf --network host -v $(pwd)/config:/free5gc/config free5gc-amf:v3.2.2 docker run -d --name smf --network host -v $(pwd)/config:/free5gc/config free5gc-smf:v3.2.2 docker run -d --name upf --network host -v $(pwd)/config:/free5gc/config free5gc-upf:v3.2.2 # 步骤 3启动 UE 模拟器指定 IMSI 和密钥与 config/udmcfg.yaml 中一致 ./build/nr-ue -c config/ue.yaml --amf 127.0.0.1:38412 --supi imsi-2089300007487 --key 5122250214c33e723a5dd523fc145fc0 --opc 916654cc334c46429a1bd7af34c4aad9 # 步骤 4抓包并过滤注册流程关键只捕获 lo 接口避免物理网卡干扰 sudo tcpdump -i lo -w registration.pcap port 38412 or port 38410 or port 8805 # 步骤 5触发注册并验证UE 控制台输出 Registration accepted 即成功 # 此时 registration.pcap 中应包含完整的 Registration Request → Accept 流程参数说明--amf 127.0.0.1:38412强制 UE 连接本地 AMF 的 SBI 接口38412 端口绕过 DNS 解析--supi和--key必须与config/udmcfg.yaml中subscribers列表完全一致否则 UDM 鉴权失败AMF 直接返回5GS Registration Reject (Cause24)port 38412 or port 38410 or port 8805分别对应 AMF-SMFNsmf_PDUSession、AMF-UDMNudm_UECM、UPF-PFCP 端口覆盖注册流程全链路。3.3 用图谱反向验证抓包结果三步定位字段偏差当registration.pcap抓包完成后用 Wireshark 打开按图谱中标注的字段位置进行三步验证定位消息在 Wireshark 过滤栏输入nas_5gs.msg_type 0x41Registration Request或nas_5gs.msg_type 0x42Registration Accept比对 IE展开NAS-PDU→5GS Registration Request→5GS Registration Type确认其值为0x01Initial Registration若为0x02Mobility Registration Update说明 UE 未清除旧上下文需在ueransim启动前执行rm -rf build/ue-context/检查长度图谱中标注5GS Registration Request的最小长度为 12 字节含 5GS Header Registration Type 5GS Mobile Identity若 Wireshark 显示长度为 10 字节说明5GS Mobile IdentitySUCI/SUPI未正确编码需检查ue.yaml中supi格式是否为imsi-XXXXXXX非IMSI-XXXXXXX。这三步验证直接暴露“理论图谱”与“实际信令”的偏差点是建立可信度的第一关。4. 避坑指南注册与会话建立流程中五个血泪经验总结4.1 现象UE 发送 Registration Request 后AMF 无任何响应Wireshark 仅看到单向包原因AMF 配置文件amfcfg.yaml中amf.sbi.bindingIPv4设置为0.0.0.0但ueransim默认尝试连接127.0.0.1若 AMF 实际监听在192.168.1.100则连接被拒绝且 AMF 日志不记录该失败因未进入 TCP 握手阶段。解决将amfcfg.yaml中amf.sbi.bindingIPv4明确设为127.0.0.1并确保ueransim启动时--amf参数与之匹配或改用--amf host-ip并在amfcfg.yaml中设为对应 IP。4.2 现象Registration Accept 成功接收但 UE 不发起 PDU Session Establishment Request原因AMF 未从 UDM 获取到用户的Session Management Subscription Data导致 AMF 无法构造PDU Session Establishment Request的触发条件。常见于udmcfg.yaml中subscribers列表未配置sessionManagementSubscriptions字段或amfcfg.yaml中amf.udm.hostname指向错误地址。解决检查udmcfg.yaml中目标 IMSI 的配置块必须包含sessionManagementSubscriptions子项示例- supi: imsi-2089300007487 authenticationManagementField: 8000 sequenceNumber: 000000000000 sessionManagementSubscriptions: - dnn: internet snssai: sst: 1 sd: 010203 qos: 5qi: 9 arp: priorityLevel: 8 preemptionCapability: true preemptionVulnerability: false4.3 现象SMF 收到 Nsmf_PDUSession_CreateSMContext Request但 UPF 无任何 PFCP 消息原因UPF 配置文件upfcfg.yaml中upf.pfcp.bindingIPv4与 SMF 配置的smf.upf.ipv4不一致或防火墙拦截 8805 端口。更隐蔽的是free5GC v3.2.2 中 UPF 默认启用gtpu模式但若upfcfg.yaml中upf.gtpu设为false则 UPF 不监听 GTP-U 端口导致 SMF 认为 UPF 不可用而跳过 PFCP 流程。解决统一upfcfg.yaml与smfcfg.yaml中的 IPv4 地址执行sudo ufw allow 8805确认upfcfg.yaml中upf.gtpu: true即使不用 GTP-U该标志也需为 true 以激活 UPF 主循环。4.4 现象PDU Session Establishment Accept 中QoS Flow Setup Response List为空UE 无法建立数据面原因SMF 在构造PFCP Session Establishment Request时QERQoS Enforcement Rule中的qerId与PDRPacket Detection Rule中的qerId不匹配UPF 拒绝创建 QoS Flow。free5GC 默认生成qerId1但若手动修改过smfcfg.yaml中smf.qos.defaultQerId而未同步更新upfcfg.yaml中upf.qer.id则失配。解决删除smfcfg.yaml中自定义的smf.qos.defaultQerId使用默认值或确保upfcfg.yaml中upf.qer.id与之完全相同。4.5 现象Handover 流程中源 gNB 发送 Handover Required 后AMF 无响应目标 gNB 收不到 Handover Request原因AMF 配置中amf.ngap.bindingIPv4未设置为目标 gNB 所在网段的地址或amfcfg.yaml中amf.ngap下plmnList未包含目标 gNB 的 PLMN如20893AMF 将丢弃来自该 PLMN 的 NGAP 消息。解决在amfcfg.yaml的amf.ngap.plmnList中添加目标 gNB 的 PLMN格式为20893字符串并确认amf.ngap.bindingIPv4为0.0.0.0或目标网段可达地址。5. 进阶技巧用 Python 脚本自动化比对信令字段与图谱标注5.1 构建字段比对引擎从 pcap 到结构化校验手动比对 Wireshark 中的字段既慢又易错。资源包提供scripts/validate_nas_fields.py它基于 Scapy 解析 pcap自动提取关键 NAS 消息字段并与图谱中标注的预期值比对。核心逻辑如下# validate_nas_fields.py from scapy.all import * import json def parse_registration_request(pcap_file): packets rdpcap(pcap_file) for pkt in packets: if UDP in pkt and pkt[UDP].dport 38412: # AMF SBI port if Raw in pkt and b\x41 in bytes(pkt[Raw]): # NAS msg type 0x41 # 提取 Registration Type 字段偏移量 3长度 1 字节 nas_payload bytes(pkt[Raw]) reg_type nas_payload[3] # 图谱标注Registration Type 位于 NAS PDU 第 4 字节 return reg_type return None if __name__ __main__: expected {Registration Type: 1} # 图谱标注Initial Registration 0x01 actual parse_registration_request(registration.pcap) if actual expected[Registration Type]: print(✅ Registration Type 校验通过) else: print(f❌ Registration Type 错误期望 {expected[Registration Type]}实际 {actual})参数说明pkt[UDP].dport 38412精准过滤 AMF 的 SBI 接口流量避免与 SMF38410或 UPF8805混淆nas_payload[3]硬编码偏移量源于图谱中对5GS Registration RequestASN.1 结构的逐字节标注Header 3 字节 Type 1 字节该脚本可扩展添加对5GS Mobile IdentitySUCI 编码校验、5GS Network Feature Supportbit 0 是否置位等字段的解析。5.2 动态生成信令流程报告HTML 时间轴可视化scripts/generate_timeline.py将 pcap 解析结果与图谱状态快照合并生成交互式 HTML 报告。它调用plotly绘制时间轴横轴为微秒级时间戳纵轴为网元AMF/SMF/UPF/UE每个气泡代表一条消息并标注消息类型如Registration Request关键 IE 值如Registration Type: 0x01网元状态变更如AMF: DEREGISTERED → REGISTERED与图谱标注的偏差标记红色边框表示字段值不符。执行命令python scripts/generate_timeline.py -p registration.pcap -o report.html生成的report.html可直接用浏览器打开点击任意气泡弹出详细 ASN.1 解码树与图谱 SVG 中的节点一一对应。5.3 用图谱指导日志关键词搜索三分钟定位 AMF 内部状态卡点当流程卡在某一步时与其全文搜索 AMF 日志不如用图谱中的状态快照描述作为关键词。例如图谱标注“AMF 在发送Nsmf_PDUSession_CreateSMContext Request前状态为REGISTERED (Pending SMF)”则在 AMF 日志中搜索Pending SMF或state REGISTERED.*Pending SMF若无结果说明 AMF 未进入该状态需检查前置的 UDM 鉴权是否完成搜索UDM Get Subscriber Data success若找到Pending SMF但后续无Nsmf_PDUSession_CreateSMContext Request则搜索SMF client error或http status 500定位 SMF 连接失败。这种基于状态的关键词搜索比盲目搜error或fail效率高 5 倍以上。我从那以后每次分析信令异常都先打开图谱找到当前卡点的状态描述再复制粘贴到日志里CtrlF—— 再也没为找错日志行浪费过半小时。希望帮到你。本文还有配套的精品资源点击获取