文章详细记录了在Python环境中安装和使用requests库及oracledb连接Oracle数据库的过程。首先展示了requests库的安装验证方法包括版本检查和使用示例。随后重点解析了Oracle数据库连接的4类常见错误模块未安装、参数错误、服务名未注册和SQL语法错误提供了详细的错误排查方法和正确代码模板。文章特别强调使用lsnrctl services查看正确服务名、移除encoding参数、SQL语句不加分号等关键点并给出了最终正确的代码示例。通过系统总结连接Oracle数据库的典型错误及解决方案为开发者提供了实用的技术参考。关联阅读推荐大数据开发数据库环境搭建Oracle Database 21c XE 和 Oracle SQL Developer 安装连接数据库创建100 万行数据分析练习pip3 install requests(global_venv) PS C:\Users\86178\PyCharmMiscProject\mumu\day cd .. (global_venv) PS C:\Users\86178\PyCharmMiscProject\mumu pip3 install requests Collecting requests Downloading requests-2.33.1-py3-none-any.whl.metadata (4.8 kB) Collecting charset_normalizer4,2 (from requests) Downloading charset_normalizer-3.4.7-cp313-cp313-win_amd64.whl.metadata (41 kB) Collecting idna4,2.5 (from requests) Downloading idna-3.11-py3-none-any.whl.metadata (8.4 kB) Collecting urllib33,1.26 (from requests) Downloading urllib3-2.6.3-py3-none-any.whl.metadata (6.9 kB) Collecting certifi2023.5.7 (from requests) Downloading certifi-2026.2.25-py3-none-any.whl.metadata (2.5 kB) Downloading requests-2.33.1-py3-none-any.whl (64 kB) Downloading charset_normalizer-3.4.7-cp313-cp313-win_amd64.whl (158 kB) Downloading idna-3.11-py3-none-any.whl (71 kB) Downloading urllib3-2.6.3-py3-none-any.whl (131 kB) Downloading certifi-2026.2.25-py3-none-any.whl (153 kB) Installing collected packages: urllib3, idna, charset_normalizer, certifi, requests Successfully installed certifi-2026.2.25 charset_normalizer-3.4.7 idna-3.11 requests-2.33.1 urllib3-2.6.3 (global_venv) PS C:\Users\86178\PyCharmMiscProject\mumu ls 目录: C:\Users\86178\PyCharmMiscProject\mumu Mode LastWriteTime Length Name ---- ------------- ------ ---- d----- 2026-04-21 下午 04:22 .idea d----- 2026-04-16 上午 09:12 AI d----- 2026-04-21 下午 04:20 day d----- 2026-04-16 上午 09:56 niuke d----- 2026-04-21 上午 09:41 review d----- 2026-04-17 上午 09:47 test安装完验证怎么没看到request呢你安装的requests库是 Python 包不会在目录里显示为文件夹。它被安装到了你的虚拟环境global_venv的Lib/site-packages目录中。验证 requests 是否安装成功的方法1.在 Python 中导入测试最直接bashpython -c import requests; print(requests.__version__)如果显示版本号如2.33.1说明安装成功。2.查看已安装的包列表bashpip list应该能看到requests在列表中。(global_venv) PS C:\Users\86178\PyCharmMiscProject\mumu pip list Package Version ------------------ --------- certifi 2026.2.25 charset-normalizer 3.4.7 idna 3.11 markdown-it-py 4.0.0 mdurl 0.1.2 pip 26.0.1 Pygments 2.20.0 requests 2.33.1 rich 15.0.0 urllib3 2.6.3从pip list的输出可以看到requests 已经成功安装了textrequests 2.33.1你现在可以正常使用requests库了。快速验证一下bashpython -c import requests; print(requests.__version__)应该会输出2.33.1。你现在可以这样使用import requests # 发送 GET 请求 response requests.get(https://www.baidu.com) print(response.status_code) # 200 表示成功 # 发送 POST 请求 # response requests.post(https://httpbin.org/post, data{key: value}) # 处理 JSON 数据 # data response.json()3.查看 requests 的安装位置bashpip show requests会显示安装路径类似textLocation: C:\Users\86178\PyCharmMiscProject\mumu\global_venv\Lib\site-packages4.进入 Python 交互环境测试bashpython import requests response requests.get(https://www.baidu.com) print(response.status_code) 200为什么ls看不到ls显示的是当前目录下的文件和文件夹Python 包安装在虚拟环境的site-packages目录不在你的项目根目录这是正常的 Python 包管理机制你可以直接运行上面的验证命令应该能正常使用requests库了测试连接数据库输出数据Oracle 21c XE 和 Python 3.13.13 兼容吗兼容。安装的Oracle 21c XE和Python 3.13.13可以配合使用官方驱动python-oracledb明确支持这一组合。只需在你的终端如命令提示符或 PowerShell执行以下命令即可完成安装bashpip install oracledb --upgrade⚙️ 两种连接模式安装后你有两种方式连接数据库推荐优先尝试Thin 模式Thin 模式 (推荐新手)这是驱动默认的模式无需安装 Oracle 客户端直接用 Python 代码就能连接非常简单省事。前提是数据库版本需为 12.1 或更高你的 21c 完全满足。Thick 模式 (高级功能)如果需要用到 Oracle 的一些高级功能如 AQ 消息队列则需额外下载Oracle Instant Client并配置环境变量连接时需切换到此模式。以下是运行成功的完整示例#第三方模块 安装 打开Python控制台终端 #项目根目录执行命令 #pip3 install requests #做爬虫的库 #安装完验证 #在Python代码中import import requests as rs import oracledb as orcl #没有名称为 oracledb 的模块? #oracledb 未下载pip install oracledb # 使用 xepdb1 服务名推荐这是可插拔数据库 config_1 { user: BIGDATA_DEV, # 改为大写 password: dev123, dsn: 127.0.0.1:1521/xepdb1 } #从报错信息 ORA-01017: 用户名/口令无效; 登录被拒绝 来看你的 Python 代码和 Oracle 数据库的连接是成功建立的问题出在身份验证这一步。 #检查是否有大小写问题Oracle 默认存储用户名是大写的但通常不区分 #不是大小写的原因密码错了已改正。 # config_1 { # user:scott, # password:123456, # dsn:127.0.0.1:1521/orcl # #encoding:UTF-8 # } # 这个错误 DPY-6001 意思是你的 Python 程序成功找到了 Oracle 监听器在 127.0.0.1 的 1521 端口但这个监听器不知道有一个叫 orcl 的服务。 # 这通常是因为连接字符串中使用的“服务名”与数据库实际注册的名称不符。 # scott 用户可能不存在或未解锁 # scott 是 Oracle 示例用户在 XE 版本中可能默认不存在 # 如果连接成功但提示用户不存在需要先创建或解锁 scott #oracledb 的 connect() 方法不支持 encoding 参数。 conn orcl.connect(**config_1) # cur conn.cursor() # cur.execute(select * from emp) # res cur.fetchall() # for i in res: ##[(7369,Smith,...),(第二行数据),(第三行数据)..] # print(i) # conn.close() try: conn orcl.connect(**config_1) print(数据库连接成功) cur conn.cursor() cur.execute(SELECT * FROM orders WHERE ROWNUM 10) res cur.fetchall() for i in res: print(i) cur.close() conn.close() except orcl.Error as e: print(f数据库错误: {e}) #现在遇到的 ORA-00933: SQL 命令未正确结束 错误是因为你 SQL 语句末尾的分号 ; 导致的。 #在 Python 的 oracledb 执行单条 SQL 语句时不需要也不能加 ;。分号是 SQL 客户端如 SQL*Plus、DBeaver中的语句分隔符但在编程接口中直接传入会报错。输出数据库连接成功 (619, 2537, Product_403, 3774.73, datetime.datetime(2025, 7, 20, 13, 24, 13), COMPLETED) (620, 2952, Product_283, 3322.63, datetime.datetime(2025, 4, 26, 13, 24, 13), COMPLETED) (621, 739, Product_1, 252.36, datetime.datetime(2025, 12, 29, 13, 24, 13), COMPLETED) (622, 5170, Product_469, 1832.32, datetime.datetime(2025, 8, 11, 13, 24, 13), COMPLETED) (623, 457, Product_407, 915.15, datetime.datetime(2025, 6, 23, 13, 24, 13), COMPLETED) (624, 4381, Product_150, 4850.8, datetime.datetime(2026, 1, 16, 13, 24, 13), PENDING) (625, 9542, Product_173, 4984.05, datetime.datetime(2025, 9, 6, 13, 24, 13), CANCELLED) (626, 4483, Product_219, 2489.47, datetime.datetime(2025, 10, 13, 13, 24, 13), PENDING) (627, 942, Product_20, 4500.96, datetime.datetime(2026, 1, 5, 13, 24, 13), PENDING) (628, 8995, Product_188, 2744.2, datetime.datetime(2026, 3, 4, 13, 24, 13), CANCELLED) 进程已结束退出代码为 0提示没有配置任何数据源来运行此 SQL 并提供高级代码辅助。 通过问题菜单(Ctrl.)禁用此检查。这个提示是 PyCharm 的代码辅助功能警告不是真正的错误。它只是表示 PyCharm 不知道你的数据库结构所以无法提供代码补全和语法检查。解决方法方法1忽略警告最简单代码仍然可以正常运行这只是编辑器的提示。点击提示框选择禁用此检查即可。方法2配置数据源推荐让 PyCharm 连接到你的 Oracle 数据库获得代码补全功能右侧边栏→Database工具窗口点击→Data Source→Oracle填写连接信息Host:127.0.0.1Port:1521Service/SID:orclUser: bigdata_devPassword: dev123点击Test Connection测试应用并确定配置成功后PyCharm 就能识别表名、字段名并提供智能提示。Oracle 数据库连接与执行错误总结根据实际操作过程共遇到4 个典型错误现总结如下错误 1模块未安装错误信息text没有名称为 oracledb 的模块原因未安装oracledbPython 包解决方案bashpip install oracledb错误 2connect() 参数错误错误信息textTypeError: connect() got an unexpected keyword argument encoding原因oracledb的connect()方法不支持encoding参数解决方案python# 错误写法 config { user: scott, password: 123456, dsn: 127.0.0.1:1521/orcl, encoding: UTF-8 # 删除此行 } # 正确写法 config { user: scott, password: 123456, dsn: 127.0.0.1:1521/orcl }错误 3服务名未注册监听器找不到服务解决方法可以按以下步骤来定位和解决问题1. 确认数据库的真实服务名打开命令提示符cmd或 PowerShell使用 Oracle 自带的lsnrctl工具来查看服务名。bashlsnrctl services在命令的输出中找到状态为READY的服务实例它旁边显示的就是你可以用来连接的、正确的服务名。它会像xepdb1或pdb1这样。2. 修正你的连接字符串找到正确的服务名后修改代码。错误信息textDPY-6001: Service orcl is not registered with the listener ORA-12514: TNS:listener does not currently know of service requested in connect descriptor原因连接字符串中的服务名orcl与数据库实际注册的服务名不符诊断方法bashlsnrctl services # 查看数据库实际注册的服务名确认数据库正在运行确保你的 Oracle 数据库服务已经成功启动处于可连接状态。检查监听器状态在命令行执行lsnrctl status确保监听器正在运行并且没有报错。输出C:\Users\86178lsnrctl services LSNRCTL for 64-bit Windows: Version 21.0.0.0.0 - Production on 22-4月 -2026 10:32:51 Copyright (c) 1991, 2021, Oracle. All rights reserved. 正在连接到 (DESCRIPTION(ADDRESS(PROTOCOLTCP)(HOSTMuJinqiu)(PORT1521))) 服务摘要.. 服务 57db0fdd4f3b4b59b5325a24da9f6512 包含 1 个实例。 实例 xe, 状态 READY, 包含此服务的 2 个处理程序... 处理程序: N000:dedicated 已建立:0 已拒绝:0 状态:ready CMON machine: MUJINQIU, pid: 36336_31144 (ADDRESS(PROTOCOLtcp)(HOST127.0.0.1)(PORT4803)) DEDICATED 已建立:0 已拒绝:0 状态:ready LOCAL SERVER 服务 CLRExtProc 包含 1 个实例。 实例 CLRExtProc, 状态 UNKNOWN, 包含此服务的 1 个处理程序... 处理程序: DEDICATED 已建立:0 已被拒绝:0 LOCAL SERVER 服务 XE 包含 1 个实例。 实例 xe, 状态 READY, 包含此服务的 2 个处理程序... 处理程序: N000:dedicated 已建立:0 已拒绝:0 状态:ready CMON machine: MUJINQIU, pid: 36336_31144 (ADDRESS(PROTOCOLtcp)(HOST127.0.0.1)(PORT4803)) DEDICATED 已建立:0 已拒绝:0 状态:ready LOCAL SERVER 服务 XEXDB 包含 1 个实例。 实例 xe, 状态 READY, 包含此服务的 1 个处理程序... 处理程序: D000 已建立:0 已被拒绝:0 当前: 0 最大: 1022 状态: ready DISPATCHER machine: MUJINQIU, pid: 36336_32672 (ADDRESS(PROTOCOLtcp)(HOSTMuJinqiu)(PORT4801)) 服务 xepdb1 包含 1 个实例。 实例 xe, 状态 READY, 包含此服务的 2 个处理程序... 处理程序: N000:dedicated 已建立:0 已拒绝:0 状态:ready CMON machine: MUJINQIU, pid: 36336_31144 (ADDRESS(PROTOCOLtcp)(HOST127.0.0.1)(PORT4803)) DEDICATED 已建立:0 已拒绝:0 状态:ready LOCAL SERVER 命令执行成功从lsnrctl services的输出可以看到你的 Oracle 数据库有多个可用的服务名。其中最常用的是XE大写xepdb1小写这是可插拔数据库关于SID和SERVICE_NAME这里有个概念需要区分一下SID是数据库实例的唯一标识符一个实例只有一个SID。SERVICE_NAME是数据库对外提供服务时的逻辑名称一个数据库可以有多个服务名是更灵活、推荐的连接方式。解决方案python# 根据 lsnrctl services 输出使用正确的服务名 config { user: scott, password: 123456, dsn: 127.0.0.1:1521/xepdb1 # 或 XE }输出解析示例text服务 xepdb1 包含 1 个实例。 # ✅ 可用的服务名 服务 XE 包含 1 个实例。 # ✅ 可用的服务名错误 4SQL 语法错误语句未正确结束错误信息textORA-00933: SQL 命令未正确结束原因在 Python 的execute()方法中SQL 语句末尾不能加分号;分号是客户端工具的分隔符不是 SQL 语法的一部分解决方案python# 错误写法 cur.execute(SELECT * FROM orders WHERE ROWNUM 10;) # ❌ 末尾有分号 # 正确写法 cur.execute(SELECT * FROM orders WHERE ROWNUM 10) # ✅ 去掉分号其他注意事项多语句执行如果你需要一次执行多个 SQL 语句例如建表插入数据可以使用cur.executescript()方法这时才需要分号分隔。ROWNUM 用法正确你在 Oracle 中使用ROWNUM 10来限制返回行数是正确的。表名确认确保orders表在当前用户模式下存在。如果提示表不存在ORA-00942可能需要指定所有者如SELECT * FROM system.orders或先授权。附加错误用户名/密码错误确认用户名和密码是否正确检查是否有大小写问题Oracle 默认存储用户名是大写的但通常不区分确认密码是否正确尝试用BIGDATA_DEV大写用户名连接代码中的orders表可能属于其他用户如systembigdata_dev需要被授权才能访问如果bigdata_dev用户确实存在可能需要重置密码ALTER USER bigdata_dev IDENTIFIED BY new_password注意事项scott 用户可能不存在或未解锁scott 是 Oracle 示例用户在 XE 版本中可能默认不存在如果连接成功但提示用户不存在需要先创建或解锁 scott错误信息textORA-01017: 用户名/口令无效; 登录被拒绝原因用户名或密码输入错误解决方案检查用户名/密码是否正确确认用户未被锁定ALTER USER username ACCOUNT UNLOCK;确认用户有相应权限GRANT CONNECT, RESOURCE TO username;用户被锁定 的含义用户被锁定是 Oracle 数据库的一种安全保护机制。当用户连续多次输入错误密码登录失败后数据库会自动将该用户账户临时锁定防止暴力破解密码。总结锁定是安全机制防止暴力破解默认触发条件连续 10 次密码错误解决办法管理员执行ALTER USER ... ACCOUNT UNLOCK;预防措施确保代码中密码配置正确避免反复用错误密码连接如果你之前遇到的是ORA-01017密码无效说明账户当时没有被锁定。但如果继续用错误密码尝试多次账户最终会被锁定变成ORA-28000。最终正确代码模板pythonimport oracledb as orcl # 正确配置无 encoding 参数使用正确的服务名 config { user: your_username, password: your_password, dsn: 127.0.0.1:1521/xepdb1 # 使用 lsnrctl services 查到的服务名 } try: conn orcl.connect(**config) print(数据库连接成功) cur conn.cursor() cur.execute(SELECT * FROM orders WHERE ROWNUM 10) # SQL 语句不加分号 res cur.fetchall() for row in res: print(row) cur.close() conn.close() except orcl.Error as e: print(f数据库错误: {e})错误排查流程图text安装 oracledb → pip install oracledb ↓ 检查参数 → 移除 encoding 等不支持参数 ↓ 确认服务名 → lsnrctl services → 使用正确的服务名如 xepdb1 ↓ 确认用户名/密码 → 检查用户状态和权限 ↓ 检查 SQL 语法 → 去掉末尾的分号 ↓ ✅ 成功执行关键要点错误类型核心原因解决方法模块未安装未安装 oracledbpip install oracledb参数错误使用了不支持的参数移除encoding等参数服务名错误服务名与数据库不符使用lsnrctl services查看正确服务名用户名密码错误认证信息不正确检查用户名/密码/用户状态SQL 语法错误SQL 语句末尾加分号删除 SQL 语句末尾的分号这些是连接 Oracle 数据库时最常见的错误掌握这些排查方法可以解决大部分连接问题。补充刚安装的 Oracle 21c XE里面也有很多表是示例用的吗是的你看到的这些表是 Oracle 预装的示例模式Sample Schemas用于学习和测试不是数据库运行所必需的。具体说明如下常见示例最典型的是HR人力资源模式包含EMPLOYEES、DEPARTMENTS等经典教学表。是否必须不是必需的。它们是可选的只为了帮你熟悉 Oracle 特性。删掉它们对数据库核心功能完全没影响。21c 的变化以前版本通常默认安装 HR但在21c XE中这些示例表可能不会自动创建。如果你看到很多表却认不出来也可能是在SYSTEM等系统表空间里切记不要操作或删除系统表否则可能导致数据库损坏。 如何确认你看到的是什么表建议你切换到之前创建的BIGDATA_DEV用户连接而不是 SYSTEM查看自己 schema 下的表sql-- 查看当前用户下的所有表 SELECT table_name FROM user_tables;orders表是新建的不是原本就有的从你的截图可以看到BIGDATA_DEV用户下目前只有你自己创建的ORDERS这一张表。这说明 Oracle 21c XE 在安装时并没有自动安装那些示例表比如经典的 HR 员工表。 结论分析之前看到的“很多表”当你用SYSTEM等高权限账号登录时看到的是 Oracle 的系统表如数据字典表它们用于管理数据库本身不是拿来练 SQL 的也绝对不能动。当前状态你现在用的BIGDATA_DEV是一个普通用户下面只有自己创建的业务表这才是我们进行开发练习的“干净”环境。 如果你需要 HR 示例表来练习很多教材尤其是考证类会用到经典的EMPLOYEES员工表、DEPARTMENTS部门表等 HR 模式。如果你确实需要可以手动安装。