Laravel Echo Server 无法连接远程Redis服务器问题求助

Let’s walk through the most common fixes for this issue—since you’ve already updated the config files, the problem is likely either a cached setting, misconfigured JSON file, or a subtle environment variable override.

1. Double-Check Your laravel-echo-server.json Redis Settings #

First, make sure the Redis block in your project’s laravel-echo-server.json is explicitly pointing to your remote server. It’s easy to miss a typo here! Your config should look something like this:

"redis": {
  "host": "your-remote-redis-ip-or-domain",
  "port": 6379, // or your custom port if you changed it
  "password": "your-redis-auth-password", // omit if no password is set
  "database": 0,
  "keyPrefix": ""
}

If you’re using environment variables in this file (like ${REDIS_HOST}), skip to step 3 to confirm your .env is set correctly.

2. Ensure You’re Loading the Correct Config File #

When you run laravel-echo-server start, it defaults to the laravel-echo-server.json in your current working directory. If you’re running the command from a different folder, or specified a custom config path with the --config flag, it might be pulling an old local config. Double-check your working directory and command syntax.

3. Flush Laravel’s Config Cache #

If you’ve ever run php artisan config:cache, Laravel caches all config values—including Redis settings. Even if you updated .env or config/database.php, the cached config will still be used. Clear it with these commands:

php artisan config:clear
php artisan cache:clear

Restart your Laravel Echo Server after doing this.

4. Verify .env Redis Variables Are Correct #

If your laravel-echo-server.json references environment variables (which is common), make sure your .env has the remote Redis details:

REDIS_HOST=your-remote-redis-ip
REDIS_PORT=6379
REDIS_PASSWORD=your-redis-password
REDIS_DB=0

Save the file and restart the Echo Server—don’t forget that .env changes don’t take effect until the service is restarted.

5. Test Remote Redis Connectivity #

Sometimes the issue isn’t config—it’s network access. Verify your server can reach the remote Redis instance:

• Use telnet your-remote-redis-ip 6379 to check if the port is open.
• Use redis-cli -h your-remote-redis-ip -p 6379 -a your-redis-password to test authentication and basic commands.
  If these fail, check the remote Redis server’s firewall rules to allow your app server’s IP, and confirm Redis is configured to accept external connections (not just localhost).

6. Debug with Verbose Logs #

Start the Echo Server with debug logs enabled to see exactly what’s happening:

laravel-echo-server start --log-level debug

Look for lines like Redis client connecting to...—this will show you the IP/port it’s actually trying to use. If it’s still local, you’ll know the config isn’t being loaded correctly. If it’s remote but failing, the logs will show errors like connection timeouts or authentication failures.

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