月度归档： 2022 年 8 月
-
在使用 vagrant ssh 登录 Homestead 虚拟机时遇到登录失败且无反应的问题，排查发现原因在于 Homestead.yaml 配置中 folders 的 map 指定本机文件夹 E:/wwwroot 的体积过大。解决方案是将映射路径更换为体积较小的 E:/wwwroot/vagrant 目录，随后执行 vagrant provision 应用配置并 vagrant reload 重启虚拟机，最终成功实现了 SSH 登录。
-
遇到 lerna ERR! yarn run prod exited 1 in ‘@theme/object’ 错误，决定删除 node_modules 目录，随后重新执行 yarn 和 yarn prod 命令以解决该问题。
-
针对在本地 Windows 10 环境执行 SQL 查询正常，而在 Linux 容器中无法查询到记录的问题，通过对比发现生成的 SQL 语句差异在于路径分隔符。分析打印生成的 SQL 与 DIRECTORY_SEPARATOR 常量，确认 Windows 环境生成反斜杠而 Linux 环境生成正斜杠，导致拼接后的路径格式不一致。删除代码中依赖 DIRECTORY_SEPARATOR 的拼接部分后，生成的 SQL 在两个操作系统中保持一致，成功解决了查询结果为 NULL 的问题。
-
本文针对 Lighthouse 中 resolver 对应的类方法 __invoke 未执行的问题进行排查。通过打印日志和调试调用栈确认构造函数正常执行但 __invoke 未被调用。对比其他正常执行的 resolver 类，发现调整 GraphQL 架构定义或解析类可恢复执行。最终定位问题根源在于该类方法内部使用了 yield 循环，删除后 __invoke 即可正常执行。
-
针对 Nuwave\Lighthouse\Schema\TypeRegistry::get() 报告类型错误，提示参数应为 string 但给出了 array 的问题，文章分析该异常发生在 TypeRegistry.php 第 553 行。解决方法是编辑相关代码，在返回参数中添加 __typename 字段以修正数据结构，从而解决类型不匹配导致的调用错误。
-
在使用 Lighthouse 过程中出现 Failed to load type: ThemeSettingRange 报错，经 GraphQL 客户端检查发现响应数据中 __typename 字段值为 ThemeSettingRange。通过调整实现方式，在该类型前添加 OnlineStore 前缀，成功解决了 Schema 定义中类型缺失的问题，使查询恢复正常。
-
启动 Vagrant 时报错 Psych::SyntaxError 提示缩进违规。经检查发现 Homestead.yaml 文件因曾用 EditPlus 编辑，在 PhpStorm 中显示红色波浪线，原因是存在 Tab 字符。在 PhpStorm 中重新格式化该文件后，红色提示消失，再次启动 Vagrant 成功，不再报错。
-
在 PHP 7.4 环境下运行代码时出现了 Illegal offset type in isset or empty 报错。经排查，变量 $setting 的值为对象，而代码直接尝试将其作为数组偏移量进行访问。通过将 $setting[‘settingId’] 转换为字符串后，再次打印数值确认转换成功，问题随之解决，程序不再报错。
-
针对 GraphQL API 响应报错提示预期 URL 类型却接收到空字符串的问题，通过打印对象发现其值为空字符串。经排查，该字段允许为 null 但对空字符串会执行 URL 规则验证。最终将值设置为 null 或符合规则的 http 开头字符串后，验证不再报错。
-
在 GraphQL API 开发中遇到了字段冲突报错，提示 default 字段存在 Float! 和 Boolean! 类型冲突。经排查，原因在于接口实现中 ThemeSettingRange 和 ThemeSettingCheckbox 的 default 字段类型不同，且在同一选择集中使用了内联片段进行查询。根据规范，同名或同别名字段必须返回相同类型。参考官方 issue，使用字段别名可以解决此问题，但这会增加客户端的解析难度。