Xdebug自动触发问题：remote_autostart为Off仍保留XDEBUG_SESSION Cookie

问题背景 #

我碰到一个挺费解的情况：phpinfo()显示xdebug.remote_autostart = Off，但每次请求后XDEBUG_SESSION=PHPSTORM的Cookie都会被保留。已经确认PhpStorm完全关闭，Xdebug Helper插件也禁用了，环境是docker + WSL2 + PHP 7.3.22 + Xdebug v2.9.8 + PhpStorm 2020.2.3，想搞清楚到底是什么在触发Xdebug设置这个Cookie。

以下是phpinfo()中完整的Xdebug配置：

xdebug.auto_trace Off Off
xdebug.cli_color 0 0
xdebug.collect_assignments Off Off
xdebug.collect_includes On On
xdebug.collect_params 0 0
xdebug.collect_return Off Off
xdebug.collect_vars Off Off
xdebug.coverage_enable On On
xdebug.default_enable Off Off
xdebug.dump.COOKIE no value no value
xdebug.dump.ENV no value no value
xdebug.dump.FILES no value no value
xdebug.dump.GET no value no value
xdebug.dump.POST no value no value
xdebug.dump.REQUEST no value no value
xdebug.dump.SERVER no value no value
xdebug.dump.SESSION no value no value
xdebug.dump_globals On On
xdebug.dump_once On On
xdebug.dump_undefined Off Off
xdebug.file_link_format no value no value
xdebug.filename_format no value no value
xdebug.force_display_errors Off Off
xdebug.force_error_reporting 0 0
xdebug.gc_stats_enable Off Off
xdebug.gc_stats_output_dir /tmp /tmp
xdebug.gc_stats_output_name gcstats.%p gcstats.%p
xdebug.halt_level 0 0
xdebug.idekey PHPSTORM PHPSTORM
xdebug.max_nesting_level 256 256
xdebug.max_stack_frames -1 -1
xdebug.overload_var_dump 2 2
xdebug.profiler_append Off Off
xdebug.profiler_enable Off Off
xdebug.profiler_enable_trigger Off Off
xdebug.profiler_enable_trigger_value no value no value
xdebug.profiler_output_dir /tmp /tmp
xdebug.profiler_output_name cachegrind.out.%p cachegrind.out.%p
xdebug.remote_addr_header no value no value
xdebug.remote_autostart Off Off
xdebug.remote_connect_back Off Off
xdebug.remote_cookie_expire_time 3600 3600
xdebug.remote_enable On On
xdebug.remote_host 172.18.31.113 localhost
xdebug.remote_log no value no value
xdebug.remote_log_level 7 7
xdebug.remote_mode req req
xdebug.remote_port 9005 9005
xdebug.remote_timeout 200 200
xdebug.scream Off Off
xdebug.show_error_trace Off Off
xdebug.show_exception_trace Off Off
xdebug.show_local_vars Off Off
xdebug.show_mem_delta Off Off
xdebug.trace_enable_trigger Off Off
xdebug.trace_enable_trigger_value no value no value
xdebug.trace_format 0 0
xdebug.trace_options 0 0
xdebug.trace_output_dir /tmp /tmp
xdebug.trace_output_name trace.%c trace.%c
xdebug.var_display_max_children 128 128
xdebug.var_display_max_data 512 512
xdebug.var_display_max_depth 3 3

排查方向与解决方法 #

• 重点检查xdebug.remote_mode = req配置：在Xdebug 2.x版本中，remote_mode=req的逻辑是Xdebug会主动尝试连接remote_host对应的地址，不管有没有触发调试的条件（比如GET参数、Cookie）。哪怕连接IDE失败，只要它启动了远程调试的初始化流程，就会自动设置XDEBUG_SESSION Cookie。你可以尝试把这个配置改成jit，jit模式下只有当存在明确的触发条件时才会启动调试流程，也就不会主动生成Cookie了。
• 排查项目代码或服务器中间件：虽然你禁用了浏览器插件，但项目里的PHP脚本、或者Nginx/Apache的配置中可能存在手动设置XDEBUG_SESSION Cookie的逻辑。可以搜索项目代码里有没有setcookie('XDEBUG_SESSION', 'PHPSTORM', ...)这类代码，或者检查服务器配置中是否有添加响应头设置Cookie的规则。
• 清除残留Cookie后测试：先手动清除浏览器中域名对应的XDEBUG_SESSION Cookie，再发起请求测试是否会重新生成，排除旧Cookie残留的干扰。
• 检查Docker镜像中的隐藏配置：有些Docker镜像会在额外的ini文件中设置Xdebug参数，可能覆盖了你在phpinfo中看到的配置。可以进入容器执行php -i | grep xdebug，或者查看/etc/php/7.3/conf.d/目录下所有Xdebug相关的ini文件，确认是否有其他地方开启了自动触发的配置。

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