discord.py 的 modal 组件不会调用名为 `callback` 的自定义方法，而是严格依赖 `on_submit` 方法作为提交处理入口；将 `callback` 重命名为 `on_submit` 并确保签名正确即可解决“something went wrong”且无控制台报错的问题。
在使用 discord.py v2.0+ 构建交互式模态窗口（Modal）时，一个常见却极易被忽略的陷阱是：开发者误以为可像 View 中的 callback 一样自定义 Modal 的处理方法名，但实际上 Modal 的生命周期由框架硬编码绑定到 on_submit 方法上。若未正确定义该方法，Discord 将无法完成交互响应流程，最终向用户显示模糊的红色错误提示 “Something went wrong”，而服务端既不抛出异常，也不输出日志——因为事件根本未进入你的逻辑。
✅ 正确写法：必须实现 on_submit(self, interaction: Interaction)
你需要将原 callback 方法重命名为 on_submit，并保持其异步属性与参数签名。以下是修正后的 HostGameModal 示例：
from discord import Interaction, TextStyle
from discord.ui import TextInput, Modal
from utils import printlog
class HostGameModal(Modal):
def __init__(self, era: str, *args, **kwargs):
super().__init__(*args, **kwargs)
self.era = era
self.add_item(TextInput(
label="Game Name",
custom_id="game_name",
placeholder="Enter your game's name"
))
self.add_item(TextInput(
label="Max Players",
custom_id="max_players",
placeholder="Enter max number of players",
style=TextStyle.short
))
self.add_item(TextInput(
label="Password",
custom_id="password",
placeholder="Enter a game password",
style=TextStyle.short
))
# ✅ 关键修正：方法名必须为 on_submit，不可改为 callback 或其他名称
async def on_submit(self, interaction: Interaction):
printlog("HostGameModal on_submit called.")
try:
# 首先 defer 响应（必须在 3 秒内调用）
await interaction.response.defer(ephemeral=True)
# 安全提取输入值（推荐通过 custom_id 查找，而非索引）
game_name = next((item.value for item in self.children if item.custom_id == "game_name"), "").strip()
max_players_str = next((item.value for item in self.children if item.custom_id == "max_players"), "").strip()
password = next((item.value for item in self.children if item.custom_id == "password"), "")
if not game_name:
await interaction.followup.send("❌ Game name is required.", ephemeral=True)
return
if not max_players_str.isdigit() or int(max_players_str) < 1:
await interaction.followup.send("❌ Max players must be a positive integer.", ephemeral=True)
return
max_players = int(max_players_str)
await interaction.followup.send(
f"✅ Hosting a '{self.era}' game named '{game_name}' with max {max_players} players.",
ephemeral=True
)
except Exception as e:
printlog(f"Error in HostGameModal on_submit: {e}")
await interaction.followup.send("❌ An unexpected error occurred. Please try again.", ephemeral=True)⚠️ 注意事项与最佳实践
- 命名强制性：on_submit 是唯一被框架识别的入口方法，callback、handle_submit 等均无效；
- 响应时效性：必须在用户点击提交后 3 秒内 调用 interaction.response.defer() 或直接 send()，否则 Discord 会中断交互并报错；
- 避免索引依赖：使用 custom_id 匹配字段值（如示例中 next(...) 方式），比 self.children[0].value 更健壮，防止因字段顺序调整导致逻辑错乱；
- 输入校验前置：在 defer() 后立即做基础校验（如空值、格式），失败时及时 followup.send() 提示，提升用户体验；
- 日志与错误隔离：printlog 应确保能真实输出（如写入文件或启用 logging），便于排查静默失败场景。
只要确保 on_submit 方法存在、签名正确、且在 defer 时限内响应，Modal 即可稳定工作——不再出现“红字报错无日志”的玄学问题。
