年度归档： 2022 年
-
在执行 vagrant up 时遇到报错，提示无法设置虚拟机名称，因为 VirtualBox 报告已存在同名虚拟机。解决方法是先删除 vagrant，随后打开 VirtualBox 图形界面确认并手动删除该虚拟机。接着根据提示删除指定目录下的虚拟机文件夹，再次执行 vagrant up 后不再报错，问题成功解决。
-
在使用 Homestead v13.2.1 运行项目时，因默认 PHP 8.0 版本与软件包依赖冲突导致 Composer 更新报错。通过修改 Homestead.yaml 配置指定站点 PHP 版本，并执行 vagrant reload –provision 重启虚拟机。在解决共享文件夹为空的问题后，下载 composer.phar 并使用 php7.4 命令执行更新，最终成功切换至 PHP 7.4.14，访问首页确认环境符合预期。
-
在使用 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’] 转换为字符串后，再次打印数值确认转换成功，问题随之解决，程序不再报错。