Free5GC Webconsole 中实时状态页面信息显示异常问题分析

问题背景

在Free5GC项目的Webconsole管理界面中，用户报告了一个关于实时状态(REALTIME STATUS)页面显示异常的问题。具体表现为：当用户点击"SHOW INFO"按钮查看AMF信息时，界面会短暂显示AMF信息后立即跳转至登录页面。

问题现象重现

该问题在特定环境下可以稳定重现：

1. 用户终端(UE)已连接并处于CONNECTED状态
2. 在Webconsole的实时状态页面中，针对特定IMSI点击"SHOW INFO"按钮
3. 界面短暂显示AMF信息后自动跳转至登录页面

技术分析

通过分析日志和代码，我们发现问题的根源在于OAuth认证流程中的令牌验证机制。当Webconsole配置启用OAuth认证时，系统会在以下情况下出现异常：

1. 用户成功登录后获取有效令牌
2. 在请求SMF信息时，系统未能正确处理令牌验证
3. 服务器返回401未授权状态码
4. 前端检测到认证失败后自动跳转至登录页面

关键日志显示：

2025-02-06T15:24:12.985164282+09:00 [INFO][WEBUI][GIN] | 401 | 10.16.82.125 | GET | /api/ue-pdu-session-info/urn:uuid:15ffeff8-eb50-4e51-a9f1-8d90aa1003fb

影响范围

该问题影响以下Webconsole版本：

• 9024b0360fc9e150b0428e25f428a4cd363e834c提交版本
• v1.3.3版本

而以下版本不受影响：

• v1.3.2版本

解决方案

开发团队通过代码审查发现，在请求SMF信息的功能实现中缺少了必要的令牌验证处理逻辑。修复方案包括：

1. 确保所有API请求都携带有效的认证令牌
2. 完善令牌刷新机制，避免因令牌过期导致的认证失败
3. 优化前端错误处理逻辑，提供更友好的用户提示

技术建议

对于使用Free5GC Webconsole的开发者和运维人员，建议：

1. 定期检查Webconsole版本更新，及时应用安全补丁
2. 在生产环境中启用详细的日志记录，便于问题排查
3. 对于关键操作界面，实现本地缓存机制以提升用户体验
4. 考虑实现会话保持功能，减少因短暂网络问题导致的认证中断

总结

这个案例展示了在微服务架构中认证机制实现的重要性。特别是在5GC这类复杂的电信系统中，各个网络功能(NF)之间的安全通信至关重要。通过这次问题的分析和解决，不仅修复了一个具体的功能缺陷，也为系统整体的安全性和稳定性提供了保障。