MacOS下执行Headless Chrome命令却启动带GUI浏览器的问题排查

核心问题：参数符号错误 #

你执行的命令里，-–headless的第二个破折号是全角破折号（–），而非标准的半角破折号（-）。Chrome无法识别这个错误格式的参数，直接忽略了无头模式配置，因此依然启动带GUI的正常模式。

修正后的命令 #

将参数改为两个半角破折号的--headless，正确命令如下：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless \
  --disable-gpu \
  http://localhost:8080

单破折号-headless现象解释 #

Chrome命令行参数规则：双破折号（--）用于指定长参数（如--headless），单破折号（-）用于短参数（如-v查看版本）。当你用-headless时，Chrome会将其识别为待访问的资源名称而非参数，自动转换为Punycode格式的域名http://xn--headless-rn3d/，这就是出现奇怪标签页的原因。

验证无头模式的方法 #

可以添加--dump-dom参数测试，该参数会直接打印目标页面的DOM内容，不会启动GUI：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless \
  --disable-gpu \
  --dump-dom \
  http://localhost:8080

如果终端能输出页面DOM，说明无头模式已正常启用。

Docker部署注意事项 #

部署到Docker时，建议使用官方Chrome镜像（如google-chrome-stable），或在Node/Express镜像中正确安装Chrome。启动命令务必使用标准半角双破折号参数，避免重复本地测试时的符号问题。

内容的提问来源于stack exchange，提问作者ChrisM