OAI-PMH2数据提供者POST请求验证失败问题求助

你遇到的这个情况其实挺常见的——核心逻辑（curl请求正常、Identify接口能过）没问题，但测试工具就是卡GetRecord的POST请求，大概率是请求细节差异或者服务器端的隐性限制导致的，咱们一步步拆解排查：

1. 先排查请求内容的格式差异 #

curl默认发送的POST数据是application/x-www-form-urlencoded格式，但有些测试工具可能会默认用multipart/form-data或者其他格式，你的PHP代码如果只处理了$_POST（依赖默认的表单编码），就会解析不到参数。

建议在你的my_oaipmh2.php开头加一段日志代码，记录请求的关键信息：

// 记录请求详情到日志文件（确保服务器有写入权限）
file_put_contents('oaipmh_request.log', date('Y-m-d H:i:s') . "\n" .
    "Content-Type: " . $_SERVER['CONTENT_TYPE'] . "\n" .
    "Raw POST: " . file_get_contents('php://input') . "\n" .
    "Parsed params: " . print_r($_REQUEST, true) . "\n\n", FILE_APPEND);

然后分别用测试工具和curl发送请求，对比日志里的内容：

• 看测试工具的Content-Type是不是和curl一致？
• 看Raw POST里的参数格式，是不是和curl的verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:www.mydataprovider/my_oaipmh2.php:1一致？

如果测试工具的POST数据格式不对，那就是工具的配置问题；如果格式一致但$_REQUEST里没有参数，那可能是服务器的参数解析有问题。

2. 检查服务器端的请求限制 #

既然curl能成功，说明代码逻辑没问题，但服务器可能对某些请求特征做了过滤：

• mod_security规则：很多托管商会启用mod_security来拦截异常请求，你的identifier里有冒号、斜杠这些特殊字符，可能触发了某些规则，导致请求被拦截或者参数被过滤。可以联系托管商，让他们检查mod_security的日志，看有没有相关的拦截记录。
• PHP POST配置：虽然你的请求参数很小，但还是可以让托管商检查post_max_size、max_input_vars这些PHP.ini设置，确保参数能被正常解析。
• User-Agent/Referer限制：有些服务器会拦截没有User-Agent或者Referer的请求，curl默认的User-Agent是curl/[version]，而有些测试工具可能不带User-Agent，或者带的User-Agent被服务器判定为异常。你可以试试在curl里去掉User-Agent，看会不会失败：

curl --data "verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:www.mydataprovider/my_oaipmh2.php:1" --user-agent "" http://www.mydataprovider/my_oaipmh2.php

如果去掉User-Agent后curl也失败了，那就是服务器的User-Agent限制问题，联系托管商调整即可。

3. 严格校验OAI-PMH响应的规范性 #

测试工具对OAI-PMH响应的校验比curl严格得多，哪怕XML有一点点不规范，都会被判定为“无效响应”：

• XML编码与HTTP头一致：确保你的响应XML开头的编码声明和HTTP头的Content-Type一致，比如XML里是<?xml version="1.0" encoding="UTF-8"?>，HTTP头必须返回Content-Type: text/xml; charset=utf-8，不能只返回text/xml。
• 命名空间完整：GetRecord响应里的oai_dc必须正确声明所有必要的命名空间，比如：

<oai_dc:dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/"
           xmlns:dc="http://purl.org/dc/elements/1.1/"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">

少了任何一个命名空间或者schemaLocation，测试工具都会判定为无效。

• 错误响应规范：如果你的代码在查询不到记录时，必须返回符合OAI-PMH规范的错误XML，比如：

<OAI-PMH xmlns="http://www.openarchives.org/OAI/2.0/"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd">
  <responseDate>2024-05-20T12:00:00Z</responseDate>
  <request verb="GetRecord" identifier="oai:xxx:1" metadataPrefix="oai_dc">http://www.mydataprovider/my_oaipmh2.php</request>
  <error code="idDoesNotExist">The requested identifier does not exist</error>
</OAI-PMH>

如果直接返回空页面或者500错误，测试工具就会提示“既没有有效响应也没有错误”。

4. 排除测试工具本身的问题 #

有些OAI-PMH测试工具会有缓存或者会话机制，导致第二次请求的参数异常。可以试试：

• 清空测试工具的缓存，或者用隐私模式打开测试工具；
• 换一个OAI-PMH测试工具再测试一次，看是不是工具的问题。

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