Payload 3.0 Beta版本模块导入报错求助

适配当前beta.108版本的导入路径调整 #

Payload v3的beta版本迭代频繁，导入路径经常有变动，你遇到的模块找不到问题，是因为教程里的路径和当前beta.108不匹配：

• 替换表单组件导入路径：
  原代码：

  import { SelectInput, useField } from 'payload/components/forms';
  

  改为beta.108的正确路径：

  import { SelectInput } from 'payload/ui/forms';
  import { useField } from 'payload/ui/hooks';
  

• 替换Field类型导入路径：
  原代码：

  import { Field } from 'payload/type';
  

  改为：

  import { Field } from 'payload/types';
  

  （注意是types复数形式，这是Payload v3的标准类型导入路径）

解决升级时的依赖冲突 #

如果必须升级到更高版本来匹配教程，试试以下步骤：

• 清理依赖缓存与旧文件：

  # npm用户
  rm -rf node_modules package-lock.json
  npm cache clean --force
  
  # yarn用户
  rm -rf node_modules yarn.lock
  yarn cache clean
  

• 强制安装指定beta版本：
  比如安装最新beta版本：

  npm install payload@latest-beta
  

  或者指定一个稳定的高版本（可根据Payload官方更新日志选择合适版本）：

  npm install payload@3.0.0-beta.150
  

• 处理顽固冲突：
  如果还是有冲突，先检查package.json中React版本是否符合Payload v3要求（必须是React 18.x）。若存在其他依赖和Payload版本冲突，可通过npm的overrides或yarn的resolutions字段强制统一版本：

  // npm在package.json中添加
  "overrides": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
  
  // yarn在package.json中添加
  "resolutions": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
  

  添加后重新执行安装命令即可。

验证 #

修改导入路径或升级完成后，重启Payload开发服务器，检查类型错误是否消失。

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