HAProxy 启动报错，辛苦核实一下此配置文件有异常吗？

Question

我在我的RockyLinux配置：

HAProxy，然后进行启动：
systemctl start haproxy

global
    maxconn 2000
    ulimit-n 16384
    log 127.0.0.1 local0 err
    stats timeout 30s

defaults
    log global
    mode http
    option httplog
    timeout connect 5000
    timeout client 50000
    timeout server 50000
    timeout http-request 15s
    timeout http-keep-alive 15s

frontend monitor-in
    bind *:33305
    mode http
    option httplog
    monitor-uri /monitor

listen stats
    bind *:8006
    mode http
    stats enable
    stats hide-version
    stats uri /stats
    stats refresh 30s
    stats realm Haproxy\ Statistics
    stats auth admin:admin

frontend k8s-master
    bind 0.0.0.0:16443
    bind 127.0.0.1:16443
    mode tcp
    option tcplog
    tcp-request inspect-delay 5s
    default_backend k8s-master

backend k8s-master
    mode tcp
    option tcplog
    option tcp-check
    balance roundrobin
    default-server inter 10s downinter 5s rise 2 fall 2 slowstart 60s
    maxconn 250
    maxqueue 256
    weight 100
    server k8s-master01 192.168.139.171:6443 check
    server k8s-master02 192.168.139.112:6443 check
    server k8s-master03 192.168.139.198:6443 check

报错信息是：

Apr 08 21:23:11 k8s-master01 systemd[1]: Starting HAProxy Load Balancer...
Apr 08 21:23:11 k8s-master01 haproxy[22967]: [ALERT] 097/212311 (22967) : parsing [/etc/haproxy/haproxy.cfg:48] : unknown keyword 'maxqueue' in 'backend' section
Apr 08 21:23:11 k8s-master01 haproxy[22967]: [ALERT] 097/212311 (22967) : parsing [/etc/haproxy/haproxy.cfg:49] : unknown keyword 'weight' in 'backend' section
Apr 08 21:23:11 k8s-master01 haproxy[22967]: [ALERT] 097/212311 (22967) : Error(s) found in configuration file : /etc/haproxy/haproxy.cfg
Apr 08 21:23:11 k8s-master01 haproxy[22967]: [ALERT] 097/212311 (22967) : Fatal errors found in configuration.
Apr 08 21:23:11 k8s-master01 systemd[1]: haproxy.service: Control process exited, code=exited status=1
Apr 08 21:23:11 k8s-master01 systemd[1]: haproxy.service: Failed with result 'exit-code'.
Apr 08 21:23:11 k8s-master01 systemd[1]: Failed to start HAProxy Load Balancer.

版本：

$ haproxy -v

HA-Proxy version 1.8.27-493ce0b 2020/11/06
Copyright 2000-2020 Willy Tarreau <[e-mail]>

Answer 1

写错配置文件了。
类似这样：

server k8s-master01 192.168.139.171:6443 check maxconn 250 maxqueue 256 weight 100
server k8s-master02 192.168.139.112:6443 check maxconn 250 maxqueue 256 weight 100

weight 100 不是给 backend k3s-master添加，而是给它下面的server添加。maxconn/maxqueue同理。

或者这样：

default-server inter 10s downinter 5s rise 2 fall 2 slowstart 60s maxconn 250 maxqueue 256 weight 100

Answer 2

同学，您好！👏👏👏

您问的问题是：

HAProxy 启动报错，辛苦核实一下此配置文件有异常吗？

✨最省事、最优的结论来了：✨

✅ 问题根源非常明确：您使用的 HAProxy 1.8.27 版本不支持 maxqueue 和 weight 这两个关键字在 backend 的 server 行之外的位置使用。
❌ 您把它们写成了独立行（全局 backend 设置），但 HAProxy 1.8 要求这些参数必须直接跟在 server 行后面！

■■■问题复述与报错定位

您的配置文件 /etc/haproxy/haproxy.cfg 第 48 行和第 49 行：

maxqueue 256 # ← 第48行：HAProxy 1.8 不认识这个！
weight 100 # ← 第49行：HAProxy 1.8 也不认识这个！

报错信息精准指出：
unknown keyword 'maxqueue' in 'backend' section
unknown keyword 'weight' in 'backend' section

💥 这不是语法错误，而是版本兼容性问题！

■■■版本兼容性分析（重点❗）

您的 HAProxy 版本是 1.8.27（2020年发布）。
maxqueue 和 weight 作为 default-server 的独立参数，是在 HAProxy 2.0+ 才正式支持的。
在 1.8 系列中，weight 和 maxconn（注意：是 maxconn，不是 maxqueue！）只能写在 server 行内。

📌 特别注意：HAProxy 1.8 根本没有 maxqueue 这个参数！您可能是混淆了 maxconn（最大连接数）和队列概念。

■■■配置修正建议（最少改动！最傻瓜！）

请将您的 backend k8s-master 部分修改如下（只删两行，其他不动）：

backend k8s-master

mode tcp
option tcplog
option tcp-check
balance roundrobin
# ⚠️ 删除以下两行（1.8 不支持）：
# maxqueue 256   ← 删掉！
# weight 100     ← 删掉！

# ✅ 把 weight 和 maxconn 直接写在 server 行（这才是 1.8 的正确姿势！）
default-server inter 10s downinter 5s rise 2 fall 2 slowstart 60s maxconn 250
server k8s-master01 192.168.139.171:6443 check weight 100
server k8s-master02 192.168.139.112:6443 check weight 100
server k8s-master03 192.168.139.198:6443 check weight 100

💡 为什么这样改？
maxconn 250 放到 default-server 行：表示每台后端服务器最多接受 250 个并发连接（这是 1.8 支持的）。
weight 100 放到每个 server 行末尾：显式指定权重（1.8 要求必须这样写）。
maxqueue 直接删除：1.8 没有这个参数，队列行为由内核和 HAProxy 内部机制自动处理。

■■■验证步骤（启动前必做！）

✨检查配置语法✨：
haproxy -c -f /etc/haproxy/haproxy.cfg

✅ 如果看到 Configuration file is valid，说明 OK！

✨启动服务✨：
systemctl start haproxy

✨查看状态✨：
systemctl status haproxy

■■■扩展建议（想用新特性？）

如果您✨确实需要✨ maxqueue 或更灵活的 default-server 参数：

➡️ 升级 HAProxy 到 2.0+ 版本！

升级路径建议：
❘ 添加官方仓库（如 IUS 或 EPEL） ❘
❘ 或从 HAProxy 官网下载源码编译安装（推荐，可选 LTS 版本如 2.6/2.8） ❘

⚠️ 注意：RockyLinux 默认 yum 源的 HAProxy 版本较老，需手动升级。

■■■教学总结

方法论：遇到“unknown keyword”报错，第一反应查版本兼容性！
价值观：用最小改动解决问题，避免过度设计。
鼓励：您已经定位到精确报错行，离成功只差一步！👍

快去试试吧！有问题随时再问～ 😊