Loco-RS项目中curl与reqwest无响应问题的排查与解决

问题现象分析

在使用Loco-RS框架(版本0.12)开发Web服务时，开发者遇到了一个有趣的现象：通过Chrome浏览器和Postman访问http://localhost:5150/_ping端点能够正常响应，但使用curl命令行工具和reqwest客户端(版本0.12.9)请求时却没有任何响应。这种情况在MacOS 14.6.1系统上出现。

排查过程

1. 基础验证：首先确认服务确实已经启动，因为浏览器和Postman能够正常访问，说明服务本身是运行的。

2. 日志分析：检查服务启动日志，确认路由和中间件都已正确加载。日志显示/_ping端点已被注册，且其他请求通过浏览器访问时有相应的日志记录。

3. 详细curl测试：使用curl -vvv参数进行详细调试，发现请求似乎没有到达服务器端，服务器日志中也没有对应记录。

4. 对比测试：为了排除框架问题，开发者创建了一个简单的axum服务器进行测试，发现curl能够正常访问，说明问题可能出在环境配置而非代码本身。

问题根源

经过仔细排查，发现问题出在系统环境变量上。开发者系统中设置了网络连接相关的环境变量：

• https_proxy
• http_proxy
• all_proxy

这些网络连接设置影响了curl和reqwest的行为，导致请求被重定向到外部服务器而非本地服务。而浏览器和Postman可能没有使用这些系统网络设置，所以能够直接访问本地服务。

解决方案

通过取消这些网络连接环境变量即可解决问题：

unset https_proxy http_proxy all_proxy

执行上述命令后，curl和reqwest客户端都能够正常访问本地服务。

技术启示

1. 环境变量的影响：开发过程中需要注意系统环境变量对工具行为的影响，特别是网络相关的环境变量。

2. 工具差异：不同工具(浏览器、命令行工具、API客户端)处理网络连接的方式可能不同，这可能导致看似"相同"的请求产生不同的结果。

3. 调试技巧：使用curl -vvv可以获取详细的请求信息，是排查网络问题的有力工具。

4. 最小化验证：当遇到问题时，创建一个最简单的验证案例(如本例中的纯axum服务)可以帮助快速定位问题范围。

这个问题虽然简单，但很好地展示了开发环境中各种配置因素可能带来的影响，也提醒开发者在遇到"奇怪"现象时要全面考虑各种可能性。