当前位置：首页 > 文章列表 > 文章 > python教程 > Streamlit端口冲突解决方法

Streamlit端口冲突解决方法

2025-11-04 15:48:35 0浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《Streamlit 端口权限错误修复方法》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

修复 Streamlit 中的 WinError 10013 端口权限错误

本文旨在解决 Streamlit 应用在 Windows 环境下运行时遇到的 WinError 10013 权限错误。该错误通常是由于默认端口被占用或权限不足导致的。教程将详细指导用户通过修改 Streamlit 配置文件，指定一个可用端口来成功启动应用，确保开发流程顺畅。

理解 WinError 10013 端口权限错误

当您在 Windows 命令行中使用 streamlit run main.py 命令启动 Streamlit 应用时，如果遇到 PermissionError: [WinError 10013] An attempt was made to access a socket in a way forbidden by its access permissions 这样的错误，这通常意味着 Streamlit 尝试使用的网络端口（默认为 8501）无法被成功绑定。

此错误主要有以下两个常见原因：

端口被占用： Streamlit 默认端口 8501 可能已经被系统上的其他应用程序（如其他开发服务器、VPN 客户端、监控工具等）占用。
权限不足： 在某些情况下，特别是尝试绑定到一些特殊端口（如小于 1024 的端口，如 80 或 443），当前用户可能没有足够的权限来执行此操作。

解决此问题的核心在于，指示 Streamlit 使用一个当前未被占用且用户有权限绑定的端口。

解决方案：修改 Streamlit 端口配置

Streamlit 提供了灵活的配置方式，允许用户通过 .streamlit/config.toml 文件来修改其运行参数，包括监听端口。

步骤一：创建或定位 Streamlit 配置文件

首先，您需要在项目目录或用户主目录下创建（或找到）Streamlit 的配置文件：

项目特定配置： 在您的 Streamlit 项目根目录下，创建一个名为 .streamlit 的文件夹（如果它不存在）。
用户全局配置： 或者，您可以在用户主目录（例如 C:\Users\YourUsername\.streamlit）下创建 .streamlit 文件夹。

在 .streamlit 文件夹内，创建一个名为 config.toml 的文件。如果该文件已存在，则直接修改它。项目特定的 config.toml 会覆盖用户全局的配置。

步骤二：添加端口配置

打开您刚刚创建或定位到的 config.toml 文件，并添加以下内容：

# 文件路径示例: your_project_root/.streamlit/config.toml
# 或 C:\Users\YourUsername\.streamlit\config.toml

[server]
port = 8080

在这个示例中，我们将 Streamlit 的监听端口设置为 8080。您可以根据实际情况选择其他未被占用的端口。

端口选择建议：

优先选择 1024 以上的端口： 这些端口通常不需要管理员权限，且与系统服务的冲突较少。常见的可选端口有 8080、5000、8502、9000 等。
避免常用系统端口： 端口 80 (HTTP) 和 443 (HTTPS) 是标准网页服务端口，可能已被 IIS、Apache、Nginx 等占用，且通常需要管理员权限才能绑定。

步骤三：重新运行 Streamlit 应用

保存 config.toml 文件后，再次在命令行中运行您的 Streamlit 应用：

streamlit run main.py

Streamlit 现在将尝试使用您在 config.toml 中指定的端口来启动服务。如果该端口可用且您有权限绑定，应用将成功启动并在浏览器中打开。

注意事项与故障排除

检查端口占用： 如果更改端口后仍然遇到 WinError 10013，可能是您选择的新端口也已被占用。您可以使用以下命令（在 Windows CMD 中）检查特定端口的占用情况：
```
netstat -ano | findstr :
```
将替换为您要检查的端口号（例如 8080）。如果命令输出显示有进程监听该端口，则说明该端口已被占用。您可以通过输出的 PID (进程 ID) 在任务管理器中查找并结束相应进程，或者选择另一个端口。
管理员权限： 尽管不推荐，但如果您坚持使用如 80 或 443 等低位端口，可能需要以管理员身份运行您的命令行（CMD 或 PowerShell），才能成功绑定。右键点击命令行图标，选择“以管理员身份运行”。
防火墙设置： 确保您的 Windows 防火墙或其他安全软件没有阻止 Streamlit 进程或所选端口的网络连接。如果应用无法从外部访问，可能需要添加入站规则来允许流量通过指定端口。
Streamlit 版本： 确保您的 Streamlit 库是最新版本，有时更新可以解决一些底层兼容性问题。

总结

WinError 10013 是 Streamlit 在 Windows 环境下常见的端口访问权限问题。通过在 .streamlit/config.toml 文件中明确指定一个未被占用且用户有权限绑定的端口，可以有效解决此问题。建议优先选择 1024 以上的端口，以避免不必要的权限冲突和系统服务干扰，确保您的 Streamlit 应用能够顺利运行。

好了，本文到此结束，带大家了解了《Streamlit端口冲突解决方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！