Laravel 8切换Octane后提示Undefined array key "REMOTE_ADDR"如何解决

问题原因 #

Laravel Octane为常驻进程架构，仅在服务启动时初始化一次全局$_SERVER变量，后续每个请求的客户端IP、请求头等动态请求参数不会同步更新到全局$_SERVER数组中，因此直接调用$_SERVER['REMOTE_ADDR']会出现索引不存在的问题。传统FPM模式下每个请求会重建整个运行环境，$_SERVER会随请求动态生成，因此可以正常获取。

解决方法 #

不要直接使用全局$_SERVER变量获取请求相关参数，改用Laravel封装的请求实例方法，该方法同时兼容FPM和Octane运行环境，还会自动处理反向代理场景下的真实IP解析逻辑：

• 直接通过助手函数获取客户端IP：request()->ip()
• 若需要获取指定$_SERVER参数，可调用请求实例的server方法：request()->server('REMOTE_ADDR')

修改后的验证器代码示例：

protected function validator(array $data)
{
    dd(request()->ip());
}

注意事项 #

如果应用前端部署了反向代理、CDN等服务，需要将代理节点的IP段配置到config/trustedproxy.php文件的proxies项中，确保可以正常解析到真实客户端IP。

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