RoundCube OAuth认证重定向触发Nginx 404错误求助

问题核心分析 #

Nginx日志显示找不到/var/www/html/index.php/login/oauth，本质是当前Nginx配置未正确将/login/oauth这类动态路由请求转发给RoundCube的index.php前端控制器处理——RoundCube的路由依赖index.php解析，而非真实存在的文件目录。

修复步骤 #

1. 调整Nginx的try_files与PHP处理规则 #

找到RoundCube站点的Nginx配置文件（通常在/etc/nginx/sites-available/或/etc/nginx/conf.d/目录下），修改配置块：

• 确保根路径的try_files指令将非静态请求导向index.php：

location / {
    try_files $uri $uri/ /index.php?$args;
}

• 检查PHP处理块，确保传递路径信息给PHP解析器：

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 根据实际PHP版本调整
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info; # 关键：传递路由路径信息
}

2. 校验RoundCube OAuth配置 #

• 确认config.inc.php中$config['oauth_provider']设为'generic'，且oauth_auth_uri、oauth_token_uri等必填参数填写无误
• 检查OAuth提供商后台的重定向URI，必须与RoundCube回调地址完全一致（包括协议http/https、域名、完整路径/login/oauth）

3. 重启服务生效配置 #

修改后执行命令重启相关服务：

sudo systemctl restart nginx
sudo systemctl restart php8.2-fpm # 对应你的PHP版本

4. 检查文件权限 #

确保Nginx进程用户（通常为www-data）拥有RoundCube目录的读取权限：

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html

验证 #

完成上述操作后，重新发起OAuth登录流程，查看Nginx日志是否仍有404报错，同时确认RoundCube能否正常完成OAuth回调与登录。

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