问题：OpenStack网络代理列表命令返回503服务不可用错误

Question

在使用 OpenStack 时，执行 `openstack network agent list` 命令返回 **503 Service Unavailable** 错误，常见于网络服务（neutron）组件异常或服务间通信故障。该问题通常由以下原因引起：Neutron 服务未正常运行、消息队列（如 RabbitMQ）连接失败、数据库访问异常，或服务 API 端点配置错误。此外，Keystone 身份认证服务不可用或 token 无效也可能导致此错误。排查时应检查 Neutron 各组件状态、日志信息、网络连通性及资源配置，确保相关服务正常运行并正确交互。

Answer 1

一、问题现象与定位

在使用 OpenStack 命令 openstack network agent list 时，返回错误信息：503 Service Unavailable。该错误通常表示 Neutron 服务或其依赖组件未能正常响应请求。

此问题的根源通常与 Neutron 服务运行状态、消息中间件（如 RabbitMQ）、数据库连接、Keystone 认证机制或服务端点配置有关。

二、常见原因分析

• Neutron 服务未正常运行：neutron-server、neutron-plugin-agent、neutron-dhcp-agent 等核心服务未启动或崩溃。
• 消息队列连接失败：RabbitMQ 或其他消息中间件配置错误或服务不可用，导致 Neutron 无法与其他组件通信。
• 数据库访问异常：数据库连接超时、权限不足或表结构异常导致 Neutron 无法读写数据。
• API 端点配置错误：Keystone 中 Neutron 的 endpoint 配置不正确，导致请求无法转发。
• Keystone 身份认证失败：token 过期、认证服务不可用或权限配置错误。

三、排查流程与诊断步骤

建议按照以下流程进行排查：

1. 确认 OpenStack 命令使用的 token 是否有效。
2. 检查 Neutron 各个服务的运行状态（systemctl status neutron-*）。
3. 查看 Neutron 的日志文件（/var/log/neutron/）。
4. 验证 RabbitMQ 是否运行正常，且 Neutron 配置正确。
5. 测试数据库连接是否正常，检查数据库状态和表结构。
6. 检查 Keystone 中 Neutron 的 service 和 endpoint 配置。

四、典型排查命令与输出示例

# 查看 Neutron 服务状态
systemctl status neutron-server
systemctl status neutron-plugin-agent
systemctl status neutron-dhcp-agent

# 查看日志
tail -f /var/log/neutron/server.log

# 检查 RabbitMQ 连接
rabbitmqctl list_queues

# 查看数据库连接
mysql -u root -p -e "SHOW DATABASES;"

# 查看 Keystone 中 Neutron endpoint
openstack endpoint list --service network
    

五、服务状态与依赖关系示意图

graph TD
            A[OpenStack CLI] -->|调用 API| B(Neutron API)
            B -->|认证| C[Keystone]
            B -->|消息通信| D[RabbitMQ]
            B -->|数据库操作| E[MySQL/MariaDB]
            B -->|代理通信| F[Nova Compute]
            B -->|网络功能| G[neutron-dhcp-agent, neutron-l3-agent]

六、解决方案与建议

问题类别	解决方案
Neutron 服务异常	重启对应服务：systemctl restart neutron-server
RabbitMQ 连接失败	检查 neutron.conf 中 rabbitmq 配置，重启服务并测试连接
数据库异常	验证数据库连接，执行 neutron-db-manage upgrade head
Keystone 配置错误	检查 endpoint 和 service 配置，重新注册 neutron 服务
Token 失效	重新获取 token：openstack token issue