PythonのAttributeError「module 'urllib' has no attribute 'urlopen'」エラーの原因と解決方法

Python 3では、urllibモジュールにおけるrequest関数へのアクセス方法が変更されました。そのため、Python 2の書き方でurlopen関数を参照しようとすると、「AttributeError: module 'urllib' has no attribute 'urlopen'」というエラーが発生します。

この記事では、このエラーの意味と発生理由を解説し、実際のコード例を通して解決方法をわかりやすく説明します。

AttributeError: module 'urllib' has no attribute 'urlopen'とは？

urllibモジュールは、URLを開いたり、Webサイトからデータを読み取ったりするためのさまざまな機能を提供しています。ただし、このライブラリの使い方はPython 2とPython 3で異なります。

Python 2では、urlopenはurllibモジュールの一部であり、urllib.urlopenとして直接呼び出すことができました。一方、Python 3では、urlopenはurllibパッケージ内のrequestサブモジュールに移動されています。

• Python 2：urllib → urlopen
• Python 3：urllib → request → urlopen

requestモジュールには、urllibパッケージに含まれるWebリクエスト関連の関数の多くがまとめられています。AttributeErrorは、モジュールに存在しない属性へアクセスしようとしたときに発生するエラーです。今回の場合、urlopenはurllibモジュール直下には存在しないため、エラーが発生します。

エラーが発生する具体例

ここでは、ダミーデータを提供するサービス「JSONPlaceholder」からデータを取得するプログラムを作成してみましょう。

IDが2の投稿データを1件取得します。まずはurllibモジュールをインポートします。

import urllib

この記述により、プログラム内でurllibモジュールの機能を使用できるようになります。

次に、urlopenを使ってJSONPlaceholder APIのエンドポイントからデータを取得します。

data = urllib.urlopen("https://jsonplaceholder.typicode.com/posts/2")
contents = data.read()
print(contents)

このコードは、JSONPlaceholder API上のIDが2の投稿データを読み取り、レスポンスをコンソールに出力するものです。実行すると、次のような結果になります。

Traceback (most recent call last):
  File "main.py", line 4, in <module>
    data = urllib.urlopen("https://jsonplaceholder.typicode.com/posts/2")
AttributeError: module 'urllib' has no attribute 'urlopen'

プログラムはエラーを返し、正常に動作しません。

解決方法

原因は、Python 2の構文でurlopenメソッドにアクセスしている点にあります。Python 3において、urlopenはurllibモジュール直下の属性ではないため、プログラムは正しく実行されません。

この問題を解決するには、urllibモジュールからrequestサブモジュールを明示的にインポートします。requestモジュールの中にurlopenメソッドが含まれています。

import urllib.request

続いて、JSONPlaceholder APIからデータを取得するコードを、urllib.requestモジュールを参照するように修正します。

data = urllib.request.urlopen("https://jsonplaceholder.typicode.com/posts/2")
contents = data.read().decode('utf-8')

print(contents)

このコードを実行すると、APIエンドポイントの内容が正しく読み込まれます。

{
  "userId": 1,
  "id": 2,
  "title": "qui est esse",
  "body": "est rerum tempore vitae\nsequi sint nihil reprehenderit dolor beatae ea dolores neque\nfugiat blanditiis voluptate porro vel nihil molestiae ut reiciendis\nqui aperiam non debitis possimus qui neque nisi nulla"
}

ここでは、受け取ったレスポンスをdecode()メソッドでデコードしています。これにより、urlopen()メソッドが返すバイト列の値を文字列として読み取れるようになります。

まとめ

Python 3では、urlopen関数はurllibモジュール直下のオブジェクトではありません。この関数を使用するには、コード内でurllib.requestをインポートし、urllib.request.urlopen()として参照する必要があります。

これで、プロのようにこのPythonエラーを解決できる知識が身につきました！