Piwik触发Rails应用服务器重复请求的问题排查与解决咨询

我运行着一台Rails服务器，最近发现单个操作会触发重复的服务器调用，而且这个现象只在加载Piwik追踪脚本时才会出现。奇怪的是，通过浏览器网络面板监测，明明只看到1次对应用服务器(myserver.com)的请求和1次对Piwik服务器(mypiwikserver.com)的请求，但服务器日志里却有两次请求记录。

服务器日志片段如下：

Processing CustomController#my_action (for 10.0.2.2 at 2018-05-11 08:38:53) [GET]
Parameters: {"id":"12345", "action":"my_action", "controller":"custom"}
... all the other stuff that gets logged ...
Completed in 251ms (View: 181, DB: 60) | 200 OK [https://myserver.com/custom/my_action/12345]
... ...
Processing CustomController#my_action (for 10.0.2.2 at 2018-05-11 08:38:55) [GET]
Parameters: {"id":"12345", "r":"876646", "h":"16", "m":"16", "s":"51", "send_image":"1", "gears":"0", "cookie":"1", "gt_ms":"1174", "uid":"dummyemail@myserver.com", "realp":"0", "java":"0", "qt":"0", "urlref":"https://myserver.com/reporting/report_builder/", "controller":"custom", "action_name":"", "idsite":"", "rec":"1", "_idts":"1525949211", "_idn":"1", "_refts":"0", "res":"1280x720", "_id":"f2fe432581e2e376", "wma":"0", "fla":"0", "_idvc":"1", "_viewts":"1525949211", "dir":"0", "action":"my_action", "url":"https://myserver.com/custom/my_action/12345", "pdf":"1", "ag":"0"}
... all other stuff
Completed in 227ms (View: 177, DB: 39) | 200 OK [https://myserver.com/custom/my_action/12345?action_name=&idsite=&rec=1&r=705226&h=16&m=16&s=52&url=https%3A%2F%2Fmyserver.com%2Fcustom%2Fmy_action%2F2408&urlref=https%3A%2F%2Fmyserver.com%2Freporting%2Freport_builder%2F&uid=ctl-support%40myserver.com&_id=f2fe432581e2e376&_idts=1525949212&_idvc=0&_idn=1&_refts=0&_viewts=&send_image=1&pdf=1&qt=0&realp=0&wma=0&dir=0&fla=0&java=0&gears=0&ag=0&cookie=1&res=1280x720&gt_ms=757]

请问这个异常的原因是什么？该怎么解决？

原因分析 #

看日志里第二次请求的参数，全是Piwik的追踪专属字段（比如rec=1、_id、res这些都是Piwik用来收集访问数据的标识），而且请求的URL指向了你的Rails接口——这是Piwik的send_image参数配置错误导致的“隐形请求”。

当Piwik的send_image设为1时，它会通过动态创建隐藏的<img>标签，把追踪数据拼在URL里发送；但如果你的Piwik追踪脚本配置时，错误地把setTrackerUrl指向了自己的Rails服务器，而不是Piwik的专属服务器地址，这个<img>标签的src就会命中你的custom/my_action/12345接口，从而触发第二次请求。

至于浏览器网络面板看不到的原因：部分旧版本浏览器或特定场景下，JS动态创建的<img>请求可能不会被网络面板完整捕获，或者被归类到非XHR请求的隐藏分类里，但服务器确实会接收到请求。

解决方法 #

1. 修正Piwik追踪脚本的核心配置

   • 找到页面中的Piwik追踪代码，重点检查setTrackerUrl这一行，确保它指向Piwik服务器的专属接口（旧版是piwik.php，新版是matomo.php），而不是你的Rails服务器地址：

     _paq.push(['setTrackerUrl', 'https://mypiwikserver.com/matomo.php']); // 必须是Piwik服务器地址
     _paq.push(['setSiteId', '你的站点ID']);
     

2. 修改追踪请求的发送方式

   • 如果不需要用图片请求的方式发送追踪数据，可以把send_image设为0，改用XMLHttpRequest发送，彻底避免<img>触发的额外请求：

     _paq.push(['setSendImage', false]);
     

3. 在Rails端临时过滤无效请求

   • 如果暂时没法修改Piwik配置，可以在CustomController#my_action里添加判断，识别Piwik的追踪请求并直接返回空图片响应，避免执行正常业务逻辑：

     def my_action
       # 判断是否为Piwik追踪请求
       if params[:rec].present? && params[:_id].present?
         render plain: '', content_type: 'image/gif'
         return
       end
       # 原来的业务逻辑代码
     end
     

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