修复:私有频道改用数字 ID,解决中文用户名导致 Pusher 频道名非法

错误原因:Pusher 频道名只允许 [a-zA-Z0-9_\-=@,.],
中文用户名(如「超级舞魅」)用于 private-user.{username} 导致
PusherException: Invalid channel name。

修复方案(改用数字 ID):
- FriendAdded/FriendRemoved 构造加 toUserId 参数
- broadcastOn() 改为 PrivateChannel('user.' . $toUserId)
- FriendController 传入 $target->id / $targetUser->id
- channels.php 鉴权改为 'user.{id}',核对 $user->id 数字相等
- frame.blade.php chatContext 加 userId
- scripts.blade.php Echo.private 改用 userId 订阅
This commit is contained in:
2026-03-01 01:41:04 +08:00
parent a44a9ce242
commit 7bae5e56ff
6 changed files with 31 additions and 31 deletions
+7 -10
View File
@@ -3,10 +3,8 @@
/**
* 文件功能:好友添加广播事件
*
* 当用户 A 添加用户 B 为好友时,向 B 的私有频道广播此事件
* B 的客户端收到后展示弹窗通知
* 携带 has_added_back 字段:若 B 已将 A 加为好友则为 true(双向好友),
* 否则为 false,前端提示 B 可以点击回加。
* 当用户 A 添加用户 B 为好友时,向 B 的私有频道广播此事件
* 频道名使用数字 IDuser.{id}),避免中文用户名导致 Pusher 频道名验证失败
*
* @author ChatRoom Laravel
*
@@ -30,28 +28,27 @@ class FriendAdded implements ShouldBroadcastNow
* 构造好友添加事件。
*
* @param string $fromUsername 发起添加的用户名(A
* @param string $toUsername 被添加的用户名(B接收通知方
* @param string $toUsername 被添加的用户名(B用于消息显示
* @param int $toUserId 被添加用户的数字 ID(用于私有频道,避免中文名非法)
* @param bool $hasAddedBack B 是否已将 A 加为好友(互相添加=true
*/
public function __construct(
public readonly string $fromUsername,
public readonly string $toUsername,
public readonly int $toUserId,
public readonly bool $hasAddedBack = false,
) {}
/**
* 广播到被添加用户的私有频道,仅本人可见
* 广播到被添加用户的私有频道(用数字 ID 命名,避免中文频道名不合法)
*/
public function broadcastOn(): Channel
{
return new PrivateChannel('user.'.$this->toUsername);
return new PrivateChannel('user.'.$this->toUserId);
}
/**
* 指定广播事件名称(短名),供前端 listen('.FriendAdded') 匹配。
*
* 默认广播名为全类名 App\Events\FriendAdded
* 指定短名后前端只需 .listen('.FriendAdded')
*/
public function broadcastAs(): string
{
+7 -10
View File
@@ -3,10 +3,8 @@
/**
* 文件功能:好友删除广播事件
*
* 当用户 A 删除用户 B 为好友时,向 B 的私有频道广播此事件
* B 的客户端收到后展示弹窗通知
* 携带 hadAddedBack 字段:若 B 之前也把 A 加为好友(互相好友)则为 true
* 前端可提示 B "是否同步移除对方"
* 当用户 A 删除用户 B 为好友时,向 B 的私有频道广播此事件
* 频道名使用数字 IDuser.{id}),避免中文用户名导致 Pusher 频道名验证失败
*
* @author ChatRoom Laravel
*
@@ -30,28 +28,27 @@ class FriendRemoved implements ShouldBroadcastNow
* 构造好友删除事件。
*
* @param string $fromUsername 发起删除的用户名(A
* @param string $toUsername 被删除的用户名(B接收通知方
* @param string $toUsername 被删除的用户名(B用于消息显示
* @param int $toUserId 被删除用户的数字 ID(用于私有频道,避免中文名非法)
* @param bool $hadAddedBack B 之前是否也将 A 加为好友(互相好友=true
*/
public function __construct(
public readonly string $fromUsername,
public readonly string $toUsername,
public readonly int $toUserId,
public readonly bool $hadAddedBack = false,
) {}
/**
* 广播到被删除用户的私有频道,仅本人可见
* 广播到被删除用户的私有频道(用数字 ID 命名,避免中文频道名不合法)
*/
public function broadcastOn(): Channel
{
return new PrivateChannel('user.'.$this->toUsername);
return new PrivateChannel('user.'.$this->toUserId);
}
/**
* 指定广播事件名称(短名),供前端 listen('.FriendRemoved') 匹配。
*
* 默认广播名为全类名 App\Events\FriendRemoved
* 指定短名后前端只需 .listen('.FriendRemoved')
*/
public function broadcastAs(): string
{
+7 -4
View File
@@ -112,8 +112,8 @@ class FriendController extends Controller
->where('towho', $me->username)
->exists();
// 广播给对方(仅对方可见),携带是否已回加的状态
broadcast(new FriendAdded($me->username, $username, $hasAddedBack));
// 广播给对方(仅对方可见),携带是否已回加的状态;用数字 ID 作为频道名,避免中文名
broadcast(new FriendAdded($me->username, $username, $target->id, $hasAddedBack));
// 若对方在线,推送聊天区悄悄话(文案根据互相状态区分)
$this->notifyOnlineUser($username, $me->username, 'added', $request->input('room_id'), $hasAddedBack);
@@ -152,8 +152,11 @@ class FriendController extends Controller
->where('towho', $me->username)
->exists();
// 广播给对方,携带之前的互相好友状态
broadcast(new FriendRemoved($me->username, $username, $hadAddedBack));
// 查询目标用户 ID(用于私有频道,避免中文名非法)
$targetUser = User::where('username', $username)->first();
// 广播给对方,携带之前的互相好友状态;用数字 ID 避免中文频道名
broadcast(new FriendRemoved($me->username, $username, $targetUser?->id ?? 0, $hadAddedBack));
// 若对方在线,推送聊天区悄悄话(文案根据互相状态区分)
$this->notifyOnlineUser($username, $me->username, 'removed', $request->input('room_id'), $hadAddedBack);
+1
View File
@@ -29,6 +29,7 @@
<script>
window.chatContext = {
roomId: {{ $room->id }},
userId: {{ $user->id }},
username: "{{ $user->username }}",
userLevel: {{ $user->user_level }},
superLevel: {{ $superLevel }},
@@ -664,7 +664,8 @@
return;
}
const myName = window.chatContext.username;
window.Echo.private(`user.${myName}`)
const myId = window.chatContext.userId;
window.Echo.private(`user.${myId}`)
.listen('.FriendAdded', (e) => {
// 用居中大卡弹窗通知(有无互相好友显示不同文案和按钮)
showFriendBanner(e.from_username, e.has_added_back);
@@ -707,10 +708,11 @@
return;
}
const myName = window.chatContext.username;
const myId = window.chatContext.userId;
const roomId = window.chatContext.roomId;
// 监听私有用户频道(单独推给某人)
window.Echo.private(`user.${myName}`)
// 监听私有用户频道(单独推给某人,用数字 ID 避免中文名频道非法
window.Echo.private(`user.${myId}`)
.listen('.BannerNotification', (e) => {
if (e.options && typeof e.options === 'object') {
window.chatBanner.show(e.options);
+4 -4
View File
@@ -27,8 +27,8 @@ Broadcast::channel('room.{roomId}', function ($user, $roomId) {
];
});
// 用户私有频道鉴权(好友通知:FriendAdded / FriendRemoved
// 只有用户名匹配的本人才能订阅
Broadcast::channel('user.{username}', function ($user, string $username) {
return $user->username === $username;
// 用户私有频道鉴权(好友通知:FriendAdded / FriendRemoved / BannerNotification
// 使用数字 ID 命名频道,避免中文用户名导致 Pusher 频道名验证失败。
Broadcast::channel('user.{id}', function ($user, int $id) {
return (int) $user->id === $id;
});