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 Internet security suite)导致的。请查看您的安全套件手册,了解如何暂时禁用此功能。例如,请参阅 如何禁用 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"
登录后无法访问 localhost
#当您在容器中或通过 SSH 会话运行 dart pub publish
时, dart pub
正在监听的 localhost
可能与浏览器中可访问的 localhost
不同。尽管您可以使用浏览器登录,但浏览器随后会抱怨 http://localhost:<port>?code=...
无法访问。
请尝试此解决方法,该方法使用命令行完成登录:
在终端窗口中,运行
dart pub publish
。在弹出的浏览器窗口中,登录。
浏览器将重定向到一个 新的 localhost URL (http://localhost:<port>?code=...
),但会抱怨该 URL 无法访问。从浏览器复制 新的 localhost URL。
在与调用
dart pub publish
的同一个容器或同一主机上的另一个终端窗口中,使用curl
命令使用 新的 localhost URL 完成登录:$ curl 'http://localhost:<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。
- 点击 隐私 图标。
- 在 阻止网站跟踪 部分下,点击 首选项 按钮。
- 在顶部图标栏中,选择 威胁 。
- 在 威胁 下,点击 受信任区域 。
- 选择 受信任的 Web 地址 选项卡。
- 点击 + 按钮,然后添加 URL
https://pub.dev
。 - 点击 确定 。
- 对
https://pub.dartlang.org
重复前两步
除非另有说明,否则本网站上的文档反映的是 Dart 3.6.0。页面最后更新于 2025-02-05。 查看源代码 或 报告问题.