Xdebug调试Stripe Webhook时无法触发断点，如何解决？

核心问题分析 #

从你提供的phpinfo()输出看，当前Xdebug配置存在关键冲突和错误：

• xdebug.remote_host被设置为ngrok地址，而非你的本地IDE地址（localhost/本地IP）
• xdebug.remote_connect_back=on会让Xdebug尝试连接Webhook请求的来源（Stripe服务器），而非你的本地调试环境，这直接导致断点无法触发

具体修复步骤 #

1. 修正Xdebug配置文件 #

打开WAMP对应Apache的php.ini（注意：需修改Apache使用的配置文件，通常是phpForApache.ini，而非CLI版本），调整以下配置：

[xdebug]
zend_extension="c:/wamp64/bin/php/php7.4.9/zend_ext/php_xdebug-2.9.6-7.4-vc15-x86_64.dll"
xdebug.remote_enable = on
; 设置为你的本地IP或localhost，确保Xdebug能回连到IDE
xdebug.remote_host=localhost
xdebug.remote_autostart=on
; 必须关闭该选项，否则Xdebug会连接Stripe服务器而非你的IDE
xdebug.remote_connect_back=off
; 设置IDEkey，需和Eclipse调试配置保持一致
xdebug.idekey=ECLIPSE
xdebug.remote_port=9000
; 开启日志便于排查问题
xdebug.remote_log="c:/wamp64/logs/remote_debug.log"

xdebug.profiler_enable = off
xdebug.profiler_enable_trigger = Off
xdebug.profiler_output_name = cachegrind.out.%t.%p
xdebug.profiler_output_dir ="c:/wamp64/tmp"
xdebug.show_local_vars=0

修改完成后重启WAMP的Apache服务，再通过phpinfo()确认配置已生效。

2. 配置Eclipse调试环境 #

• 打开Eclipse的Debug Configurations，找到对应PHP Web Page的调试配置
• 在Server标签页确认服务器指向你的WAMP本地环境
• 在Debugger标签页，确保IDE Key设置为ECLIPSE（与php.ini中的xdebug.idekey一致）
• 激活Eclipse的调试监听：点击调试按钮旁的小箭头，选择Start Listening for PHP Debug Connections

3. 测试Webhook调试 #

方式一：使用Stripe CLI（推荐）

Stripe CLI可本地转发Webhook请求，方便添加调试参数：

1. 安装并登录Stripe CLI
2. 运行命令转发Webhook到你的ngrok地址，同时携带Xdebug触发参数：

   stripe listen --forward-to https://your-ngrok-id.ngrok.io/?XDEBUG_SESSION_START=ECLIPSE
   

3. 触发测试支付事件，此时Xdebug应能连接Eclipse并触发断点。

方式二：修改Stripe Webhook地址

在Stripe后台的Webhook设置中，将地址修改为：

https://your-ngrok-id.ngrok.io/?XDEBUG_SESSION_START=ECLIPSE

触发事件后，请求会携带Xdebug触发参数，配合xdebug.remote_autostart=on即可触发调试。

4. 日志排查 #

若仍无法触发断点，查看c:/wamp64/logs/remote_debug.log：

• 若日志显示Could not connect to host，说明xdebug.remote_host设置错误，或本地防火墙/杀毒软件拦截了9000端口
• 若日志显示Connected to client但断点未触发，检查Eclipse断点是否设置在有效代码行（非注释/空行）

额外注意事项 #

• 确保本地IDE（Eclipse）与WAMP处于同一网络环境，或xdebug.remote_host设置为你的公网IP（使用ngrok时需确保端口转发正确）
• 不可同时开启xdebug.remote_connect_back与手动设置xdebug.remote_host，二者互斥

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