常见问题排查
==========

端口已被占用
----------

如果看到 ``Address already in use`` 错误：

.. code-block:: bash

    # 查找使用端口的进程
    lsof -i :7000
    lsof -i :8000

    # 终止进程
    kill -9 <PID>

响应中缺少SN字段
---------------

**问题**：响应消息不包含SN或SN值不正确。
**解决方案**：确保使用最新代码：

.. code-block:: bash

    git pull  # 获取最新更改
    python main.py --all  # 重启服务器

Token刷新失败（离子阱和中性原子）
---------------------------

**问题**：``MsgUpdateToken`` 返回空或无效的令牌。
**解决方案**：
1. 确保在 ``Authorization`` 头中发送 ``RefreshToken``。
2. 检查刷新令牌是否之前从 ``MsgGetToken`` 获得。
3. 验证令牌未过期。

任务状态未发布
-----------

**问题**：客户端未通过发布-订阅接收到任务状态更新。
**解决方案**：
1. 验证发布服务器正在运行（检查端口8000-8003）。
2. 确保订阅者订阅了正确的主题。
3. 检查防火墙是否允许发布服务器端口。