Symfony集成Mercure出现JWT授权401错误及同网跨机访问失败问题

一、配置错误点梳理 #

• 1. JWT参数配置逻辑错误：Symfony Mercure组件的MERCURE_JWT_SECRET配置项，使用Symfony内置Mercure服务时，需要填写的是用来签名JWT的原始密钥，而非生成好的JWT字符串。你将生成的JWT串填入该配置项，会触发签名校验不通过的401错误。
• 2. 公共URL绑定错误：当前MERCURE_PUBLIC_URL配置的是127.0.0.1回环地址，该地址仅支持本机访问，局域网其他设备访问时会请求自身的8000端口，自然无法连通服务。
• 3. Symfony服务监听地址限制：默认Symfony本地服务仅监听127.0.0.1，未绑定局域网网卡地址，导致其他设备无法访问。

二、分步修复方案 #

步骤1：修正Mercure环境变量配置 #

修改.env文件内的Mercure相关配置如下：

# 服务端内部调用Mercure的地址，使用回环地址即可
MERCURE_URL=https://127.0.0.1:8000/.well-known/mercure
# 公共访问地址替换为你的实际局域网IP，或使用相对路径适配多场景
MERCURE_PUBLIC_URL=https://192.168.XXX.XXX:8000/.well-known/mercure
# 此处填写原始签名密钥，不要填生成的JWT串，注意不要加多余引号
MERCURE_JWT_SECRET=!ChangeMe!

提示：生产环境请务必将!ChangeMe!替换为自定义高强度密钥。

步骤2：启动服务时绑定所有网卡 #

原symfony server:start命令默认仅监听回环地址，替换为如下命令启动：

symfony server:start --listen=0.0.0.0:8000

服务会监听本机所有网卡的8000端口，局域网内其他设备即可通过你的局域网IP正常访问。

步骤3：权限验证 #

你使用的JWT payload已配置publish: ["*"]，允许发布所有主题，与代码内的http://mercure/asdf主题匹配，配置修正后不会再出现主题匹配或授权错误。

三、可选适配优化 #

如果需要同时兼容本机、局域网等多场景访问，可以将MERCURE_PUBLIC_URL设置为相对路径：

MERCURE_PUBLIC_URL=/.well-known/mercure

客户端会自动拼接当前访问的域名/IP，无需手动写死地址。

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