Filemaker PHP Web Publishing更换新主机地址后同步失效问题咨询

故障排查步骤 #

• 先修正配置语法错误：你贴出的新主机地址配置末尾缺少闭合单引号，还多余了空格，先调整为$FileMakerHost = 'https://a*****2.fmphost.com';，优先排除这类低级语法错误。
• 检查HTTPS网络连通性：原服务使用HTTP 8080端口，新服务使用HTTPS默认443端口，先确认Laravel服务器所在网络能正常访问云FMS19的443端口，没有被安全组、WAF或者防火墙拦截。可以在Laravel服务器上用curl命令测试连通性：curl -v https://a*****2.fmphost.com/fmi/xml/FMPXMLRESULT.xml -d "-db=db_fm&-lay=你的布局名&-view"，查看返回状态是否正常。
• 验证PHP Web Publishing兼容性：确认你使用的FileMaker PHP API版本和FMS19匹配，FMS19对旧版PHP API存在部分兼容性问题，优先使用和FMS19版本对应的官方PHP API。同时确认云FMS19的PHP Web Publishing端点路径和原FMS15配置一致。
• 捕获接口返回错误：在Laravel的同步任务代码中添加FileMaker接口错误捕获逻辑，调用接口后用isError($result)方法判断返回结果，打印具体的错误码和错误描述，FMS返回的标准错误码可以直接定位问题：比如16代表权限不足，100代表布局不存在，999代表网络请求失败。
• 核对账号扩展权限：即使数据库访问密码未变更，也要确认db_fm对应的访问账号已经开启fmphp扩展权限，FMS19默认不会给新建/迁移的账号自动开启该权限，迁移备份过程中也可能出现扩展权限配置丢失的情况，需要手动进入数据库安全设置检查开启。
• 排查SSL证书验证问题：Laravel的HTTP客户端默认会验证SSL证书有效性，如果云FMS19使用自签名证书，或者证书链不完整，会导致HTTPS请求被拦截。可以临时添加配置关闭SSL验证测试是否恢复正常（生产环境需修复证书问题，不建议长期关闭验证），如果使用官方FileMaker PHP API，可以设置$fm->setSSLVerify(false);测试。

双服务器同步兼容配置方案 #

• 在Laravel的.env配置文件中新增两组独立的FMS连接配置，分开存储本地和云服务器的连接参数：

# 本地FMS15配置
FMS_LOCAL_HOST=http://77.**.***.40:8080
FMS_LOCAL_DB=db_fm
FMS_LOCAL_USER=访问账号
FMS_LOCAL_PASS=访问密码
FMS_LOCAL_SSL_VERIFY=false

# 云FMS19配置
FMS_CLOUD_HOST=https://a*****2.fmphost.com
FMS_CLOUD_DB=db_fm
FMS_CLOUD_USER=访问账号
FMS_CLOUD_PASS=访问密码
FMS_CLOUD_SSL_VERIFY=true

• 封装独立的FMS连接工具方法，根据传入的标识参数返回对应服务器的连接实例，避免在业务代码中硬编码连接信息。
• 修改cron同步任务逻辑，支持双写模式：同步数据时优先写入本地FMS15，再写入云FMS19，两边都返回成功才标记同步完成，任意一边写入失败就记录错误日志并触发告警，迁移期间用该模式可以保证两边数据完全一致。
• 新增双写开关配置，迁移验证完成后可以直接关闭本地FMS的写入逻辑，不需要修改核心同步代码。

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