pub 故障排除
发布包时出现“403”错误
#运行pub publish
时出现以下错误
HTTP error 403: Forbidden
...
You aren't an uploader for package '<foo>'
如果您的一个帐户被授予发布包的权限,但 pub 客户端使用另一个帐户注册您,则可能会出现此问题。
您可以通过删除 pub 凭据文件来重置 pub 的身份验证过程
Linux
#如果定义了$XDG_CONFIG_HOME
$ rm $XDG_CONFIG_HOME/dart/pub-credentials.json
否则
$ rm $HOME/.config/dart/pub-credentials.json
macOS
#$ rm $HOME/Library/Application Support/dart/pub-credentials.json
Windows
#如果您使用的是命令提示符
$ del "%APPDATA%\dart\pub-credentials.json"
如果您使用的是 PowerShell
$ Remove-Item -Path "%APPDATA%\dart\pub-credentials.json"
发布包时出现“UnauthorizedAccess”错误
#运行pub publish
时出现以下错误
UnauthorizedAccess: Unauthorized user: <username> is not allowed to upload versions to package '<foo>'.
如果您不在授权发布新版本包的人员列表中,您将看到此消息。请参阅上传者。
Pub build 由于 HttpException 错误而失败
#运行pub build
时,您会收到类似于以下内容的 HttpException 错误
Pub build failed, [1] IsolateSpawnException: 'HttpException: Connection closed while receiving data,
...
library handler failed
...
这可能是某些防病毒软件(例如 AVG 2013 互联网安全套件)导致的。请查看安全套件的手册,了解如何暂时禁用此功能。例如,请参阅如何禁用 AVG 组件。
Pub get 在公司防火墙后面失败
#从命令行,pub 会遵守http_proxy
和https_proxy
环境变量。您可以按如下方式设置代理服务器环境变量。
在 Linux/macOS 上
$ export https_proxy=hostname:port
在 Windows 命令提示符上
$ set https_proxy=hostname:port
在 Windows PowerShell 上
$ $Env:https_proxy="hostname:port"
如果代理需要凭据,您可以按如下方式设置它们。
在 Linux/macOS 上
$ export https_proxy=username:password@hostname:port
在 Windows 命令提示符上
$ set https_proxy=username:password@hostname:port
在 Windows PowerShell 上
$ $Env:https_proxy="username:password@hostname:port"
登录后本地主机无法访问
#当您在容器中或通过 SSH 会话运行dart pub publish
时,dart pub
正在侦听的localhost
可能与浏览器中可访问的localhost
不同。虽然您可以使用浏览器登录,但浏览器随后会抱怨无法访问https://127.0.0.1:<port>?code=...
。
尝试此解决方法,该方法使用命令行完成登录
在终端窗口中,运行
dart pub publish
。在弹出的浏览器窗口中,登录。
浏览器重定向到一个新的 localhost URL(https://127.0.0.1:<port>?code=...
),但抱怨该 URL 无法访问。从浏览器复制新的 localhost URL。
在同一容器或与调用
dart pub publish
的同一主机上的另一个终端窗口中,使用curl
命令使用新的 localhost URL完成登录$ curl 'https://127.0.0.1:<port>?code=...'
尝试查找包时出现套接字错误
#如果您没有互联网访问权限、您的 ISP 正在阻止pub.dev
或安全软件正在阻止dart
的互联网访问,则可能会出现以下错误。
Got socket error trying to find package ... at https://pub.dev.
pub get failed (server unavailable) -- attempting retry 1 in 1 second...
检查您的互联网连接,并验证您没有防火墙或其他阻止dart
访问互联网的安全软件。
Kaspersky Internet Security 的详细说明
当您从菜单栏关闭Kaspersky Internet Security保护时,VPN 应用程序过滤器sysextctrld
仍在后台运行。此过滤器会导致无法连接到pub.dev
。要解决此问题,请将https://pub.dev
和https://pub.dartlang.org
都添加到受信任区域
- 打开 Kaspersky Internet Security。
- 单击隐私图标。
- 在阻止网站跟踪部分下,单击首选项按钮。
- 在顶部图标栏中,选择威胁。
- 在威胁下,单击受信任区域。
- 选择受信任的网络地址选项卡。
- 单击+按钮,并添加 URL
https://pub.dev
。 - 单击确定。
- 对
https://pub.dartlang.org
重复前两步
除非另有说明,否则此网站上的文档反映了 Dart 3.5.3。页面上次更新于 2024-02-07。 查看源代码 或 报告问题。