出现 invalid characters in username，说明服务器在登录握手中拒绝了玩家名称。地址与 Katofrp 通道通常已经可达，重点检查启动器中实际发送的用户名。
- 错误含义
- 用户名包含服务器不接受的字符
- 常见来源
- 离线档案名、启动器账户配置
- 建议格式
- 字母、数字与下划线
- 链路状态
- 通常已经连接到服务器
Katofrp 常见问题原始文档https://www.frp.moe/question.html
查看参考原文 先判断问题位置
Minecraft Java 服务器通常只接受由英文字母、数字和下划线组成、长度合规的玩家名。中文、空格、特殊标点或不可见字符会触发拒绝。
正版账号名称应通过官方账号流程修改；使用第三方启动器时，也要保证本地档案名与服务器认证模式兼容。
一次只改变一项
记录错误原文和发生阶段，完成一项后重复相同测试，才能确认真正有效的处理步骤。
处理前准备
- 截取错误原文
- 查看启动器当前账户或离线档案名
- 确认服务器是否开启正版验证
- 保存白名单与权限插件配置
- 退出所有 Minecraft 进程
按顺序处理
- 检查用户名字符
改用英文字母、数字和下划线，不使用中文、空格、连字符或表情。
- 检查长度
保持 Java 版用户名常见的 3–16 个字符范围。
- 删除旧档案并重建
启动器可能缓存旧名称，移除对应离线档案后重新创建。
- 重新登录正版账号
正版玩家从启动器退出并重新登录，确认游戏内显示名称与账号一致。
- 核对白名单
改名后服务器会把它视作不同玩家，房主需重新检查白名单和权限。
- 重新连接
完全重启游戏后使用原 Katofrp 地址测试。
验证与补充
不可见空格
复制粘贴的名称末尾可能带空格，建议手动重新输入。
权限数据
改名可能影响按名称保存的权限或玩家数据，公开服务器应先备份并使用 UUID 兼容的插件。
错误拼写
原始提示常写作 invalid characters in username；搜索时可使用完整英文错误。
仍未解决时
根据当前现象选择对应分支，保留可工作的配置和存档备份。
名称看起来正确仍失败
检查是否含全角字符、不可见空格或启动器仍在使用另一账户档案。
改名后进了新角色
可能是服务器认证模式或 UUID 发生变化，立即停止写入并让房主从备份核对玩家数据。
所有玩家突然失败
检查服务端登录插件、认证代理与最近更新。
常见问答
需要重建 Katofrp 映射吗？
不需要，用户名错误与映射端口无关。
中文用户名可以吗？
标准 Java 服务器通常不接受，应使用合规英文字符名称。
改名会丢存档吗？
玩家数据与 UUID、服务器认证模式有关，房主应在修改前备份。