内容

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

#

如果您使用的是命令提示符

cmd
$ 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_proxyhttps_proxy环境变量。您可以按如下方式设置代理服务器环境变量。

在 Linux/macOS 上

$ export https_proxy=hostname:port

在 Windows 命令提示符上

cmd
$ set https_proxy=hostname:port

在 Windows PowerShell 上

$ $Env:https_proxy="hostname:port"

如果代理需要凭据,您可以按如下方式设置它们。

在 Linux/macOS 上

$ export https_proxy=username:password@hostname:port

在 Windows 命令提示符上

cmd
$ 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=...

尝试此解决方法,该方法使用命令行完成登录

  1. 在终端窗口中,运行dart pub publish

  2. 在弹出的浏览器窗口中,登录。
    浏览器重定向到一个新的 localhost URLhttps://127.0.0.1:<port>?code=...),但抱怨该 URL 无法访问。

  3. 从浏览器复制新的 localhost URL

  4. 在同一容器或与调用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.devhttps://pub.dartlang.org都添加到受信任区域

  1. 打开 Kaspersky Internet Security。
  2. 单击隐私图标。
  3. 阻止网站跟踪部分下,单击首选项按钮。
  4. 在顶部图标栏中,选择威胁
  5. 威胁下,单击受信任区域
  6. 选择受信任的网络地址选项卡。
  7. 单击+按钮,并添加 URL https://pub.dev
  8. 单击确定
  9. https://pub.dartlang.org重复前两步