Discord.js Bot Not Receiving Messages: Diagnosing Missing Privileged Intents

Recognizable condition

The bot logs show a successful ready event, but the messageCreate handler never runs when users send messages in any text channel.

Cause and diagnostic table

Ordered checks

1. Inspect the client initialization code: verify that GatewayIntentBits.GuildMessages and GatewayIntentBits.MessageContent are present in the intents array.
2. Open the Discord Developer Portal, select your bot application, go to Bot → Privileged Gateway Intents and confirm that both toggles are switched on.
3. After confirming the code and portal settings, restart the bot process and watch the logs for the ready event.

Fixes tied to findings

• If the intents array is missing one or both bits, add them:

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [
  GatewayIntentBits.Guilds,
  GatewayIntentBits.GuildMessages,
  GatewayIntentBits.MessageContent
]});

• If the portal toggles are off, turn them on, then save changes.
• After making either change, restart the bot (e.g., pm2 restart my-bot or Ctrl+C then node index.js).

Escalation criteria

If message events still do not fire after verifying intents and restarting:

• Check shard readiness: ensure client.ws.status === 0 (WebSocket OPEN) for each shard.
• Look for rate‑limit warnings in the console (429 responses).
• Review any errors emitted on the shardError or error events.
• Collect the bot’s intent bitfield (client.intents.bitfield) and the portal settings, then file an issue on the Discord.js repository with logs and the intent configuration.