如何修复Discord Bot文件以按需快速同步Cog斜杠命令

核心问题分析 #

1. 你的斜杠命令默认注册为全局命令，是因为Pycord的discord.slash_command默认不指定服务器范围
2. bot.tree.sync()报错是因为Pycord不使用bot.tree这个API，它的命令同步方法是bot.sync_commands()

解决方案 #

一、修复同步命令报错 #

替换原有的sync命令为以下代码，使用Pycord原生的同步方法：

@bot.command(name="sync") 
async def sync(ctx):
    # 确保SERVER_ID是整数（环境变量读取的是字符串）
    guild_id = int(SERVER_ID)
    # 同步命令到指定服务器
    synced = await bot.sync_commands(guild_ids=[guild_id])
    print(f"Synced {len(synced)} command(s) to guild {guild_id}.")
    await ctx.respond(f"已同步 {len(synced)} 条命令到当前服务器！")

二、将斜杠命令设置为服务器专属 #

有两种便捷方式可选：

方式1：全局默认服务器命令（推荐）

在初始化discord.Bot时指定guild_ids，所有未单独配置的命令都会默认注册到该服务器：

# main.py中修改Bot初始化代码
SERVER_ID = int(os.getenv("DISCORD_GUILD"))  # 先转成整数
bot = discord.Bot(guild_ids=[SERVER_ID])

这种方式下，你的Cog代码不需要任何修改，命令自动变为服务器专属。

方式2：单独为每个命令指定服务器

在Cog的命令装饰器中添加guild_ids参数：

# Greetings cog中的命令修改
@discord.slash_command(
    name="hello", 
    description="Greets the messenger",
    guild_ids=[int(os.getenv("DISCORD_GUILD"))]
) 
async def hello(self, ctx):
    await ctx.respond('Hello!')

@discord.slash_command(
    name="goodbye", 
    description="Says goodbye to the messenger",
    guild_ids=[int(os.getenv("DISCORD_GUILD"))]
) 
async def goodbye(self, ctx):
    await ctx.respond('Goodbye!')

完整修改后的代码示例 #

main.py #

import discord
import os
from dotenv import load_dotenv, dotenv_values

# 加载环境变量
env_path = os.path.join(os.path.dirname(__file__), '..', 'secrets', '.env')
load_dotenv(env_path)
   
# 调试用，生产环境删除
config = dotenv_values(env_path)
print(config) 

# 环境变量转正确类型
BOT_TOKEN = os.getenv("DISCORD_TOKEN")
SERVER_ID = int(os.getenv("DISCORD_GUILD"))
BOT_ID = os.getenv("DISCORD_APPLICATION")

# 初始化Bot并指定默认服务器
bot = discord.Bot(guild_ids=[SERVER_ID])

# Bot就绪事件
@bot.event
async def on_ready():
    print(f"{bot.user} is ready and online!")
     
# 加载Cogs
cogs_list = [
    'greetings',
    'hydrocalc',
]

for cog in cogs_list:
    bot.load_extension(f'cogs.{cog}')

# 修复后的同步命令
@bot.command(name="sync") 
async def sync(ctx):
    synced = await bot.sync_commands(guild_ids=[SERVER_ID])
    print(f"Synced {len(synced)} command(s) to guild {SERVER_ID}.")
    await ctx.respond(f"已同步 {len(synced)} 条命令到当前服务器！")
    
bot.run(BOT_TOKEN)

Greetings Cog（方式1下无需修改） #

import discord
from discord.ext import commands

class Greetings(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @discord.slash_command(name="hello", description="Greets the messenger") 
    async def hello(self, ctx):
        await ctx.respond('Hello!')
        
    @discord.slash_command(name="goodbye", description="Says goodbye to the messenger") 
    async def goodbye(self, ctx):
        await ctx.respond('Goodbye!')

def setup(bot): 
    bot.add_cog(Greetings(bot)) 

注意事项 #

• 服务器命令同步后几分钟内即可生效，全局命令则需要1小时左右，测试阶段优先用服务器命令
• 确保Bot在目标服务器中拥有applications.commands权限
• 环境变量中的DISCORD_GUILD必须是服务器的纯数字ID，读取后一定要转成整数类型

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