Pylucene导入org模块失败及RAMDirectory导入错误求助

问题背景 #

测试PyLucene库时，最初使用如下导入代码：

# Common imports:
import sys
from os import path, listdir

from org.apache.lucene.document import Document, Field, StringField, TextField
from org.apache.lucene.util import Version
from org.apache.lucene.store import RAMDirectory
from datetime import datetime

# Indexer imports:
from org.apache.lucene.analysis.miscellaneous import LimitTokenCountAnalyzer
from org.apache.lucene.analysis.standard import StandardAnalyzer
from org.apache.lucene.index import IndexWriter, IndexWriterConfig
# from org.apache.lucene.store import SimpleFSDirectory

# Retriever imports:
from org.apache.lucene.search import IndexSearcher
from org.apache.lucene.index import DirectoryReader
from org.apache.lucene.queryparser.classic import QueryParser

# ---------------------------- global constants ----------------------------- #

BASE_DIR = path.dirname(path.abspath(sys.argv[0]))
INPUT_DIR = BASE_DIR + "/input/"
INDEX_DIR = BASE_DIR + "/lucene_index/"

运行后报错：

bigissue@vmi995554:~/myluceneproj$  cd /home/bigissue/myluceneproj ; /usr/bin/env /usr/bin/python3.10 /home/bigissue/.vscode/extensions/ms-python.python-2022.16.1/pythonFiles/lib/python/debugpy/adapter/../../debugpy/launcher 36991 -- /home/bigissue/myluceneproj/hello_lucene.py 
Traceback (most recent call last):
  File "/home/bigissue/myluceneproj/hello_lucene.py", line 29, in <module>
    from org.apache.lucene.document import Document, Field, StringField, TextField
ModuleNotFoundError: No module named 'org'

执行python3.10 -m pip list确认已安装lucene模块，但无法识别org模块。

后续完成以下操作：

1. 下载Lucene 9.1并在/etc/environment设置环境变量：

CLASSPATH=".:/usr/lib/jvm/temurin-17-jdk-amd64/lib:/home/bigissue/all_lucene/lucene-9.4.1/modules:/home/bigissue/all_lucene/lucene-9.1.0/modules" export CLASSPATH

2. 下载PyLucene-9.1.0，先安装JCC：

bigissue@vmi995554:~/all_lucene/pylucene-9.1.0$ pwd
/home/bigissue/all_lucene/pylucene-9.1.0/jcc
bigissue@vmi995554:~/all_lucene/pylucene-9.1.0$ python3.10 setup.py build
bigissue@vmi995554:~/all_lucene/pylucene-9.1.0$ python3.10 setup.py install

3. 下载Apache Ant，修改PyLucene的Makefile：

PREFIX_PYTHON=/usr/bin
ANT=/home/bigissue/all_lucene/apache-ant-1.10.12
PYTHON=$(PREFIX_PYTHON)/python3.10
JCC=$(PYTHON) -m jcc --shared
NUM_FILES=10

4. 执行make和make install完成安装，再次确认lucene 9.1.0已安装。

修改代码为：

import sys
from os import path, listdir
from lucene import * 

directory = RAMDirectory()

运行后报错：

ImportError: cannot import name 'RAMDirectory' from 'lucene' (/usr/local/lib/python3.10/dist-packages/lucene-9.1.0-py3.10-linux-x86_64.egg/lucene/__init__.py)

错误原因分析 #

• 第一个错误（找不到org模块）：PyLucene 9.x版本已将所有类整合到lucene包下，不再支持旧版本（如4.x）的org.apache.lucene Java风格导入路径，直接使用org开头的导入会失效。
• 第二个错误（无法从lucene导入RAMDirectory）：Lucene 9.x中RAMDirectory已被废弃并移除，替代类为ByteBuffersDirectory；另外PyLucene 9.x必须先初始化VM环境才能调用类，直接导入后使用会触发错误。

解决步骤 #

步骤1：修正导入方式并替换废弃类 #

调整代码导入路径至lucene包下，替换废弃类并添加VM初始化代码：

import sys
from os import path, listdir
import lucene
from lucene import ByteBuffersDirectory, Document, StringField, TextField, \
    StandardAnalyzer, IndexWriter, IndexWriterConfig, IndexSearcher, \
    DirectoryReader, QueryParser

# 初始化Lucene VM
lucene.initVM(vmargs=['-Djava.awt.headless=true'])

# 示例代码：创建内存目录
directory = ByteBuffersDirectory()

步骤2：统一PyLucene与Lucene版本 #

确保安装的PyLucene和Lucene版本严格一致（当前使用PyLucene 9.1.0，需对应Lucene 9.1.0），修改/etc/environment中的CLASSPATH，仅保留对应版本的Lucene模块路径：

CLASSPATH=".:/usr/lib/jvm/temurin-17-jdk-amd64/lib:/home/bigissue/all_lucene/lucene-9.1.0/modules" export CLASSPATH

执行source /etc/environment使环境变量立即生效。

步骤3：验证环境正确性 #

运行以下测试代码确认配置正常：

import lucene
lucene.initVM()
from lucene import ByteBuffersDirectory, Document, StringField, StandardAnalyzer, IndexWriterConfig, IndexWriter, IndexSearcher, QueryParser, DirectoryReader

# 创建内存索引目录
dir = ByteBuffersDirectory()
# 初始化分析器与索引写入器
analyzer = StandardAnalyzer()
config = IndexWriterConfig(analyzer)
writer = IndexWriter(dir, config)
# 添加测试文档
doc = Document()
doc.add(StringField("id", "1", StringField.Store.YES))
doc.add(TextField("content", "test content", TextField.Store.YES))
writer.addDocument(doc)
writer.close()

# 执行搜索测试
searcher = IndexSearcher(DirectoryReader.open(dir))
parser = QueryParser("content", analyzer)
query = parser.parse("test")
hits = searcher.search(query, 10).scoreDocs
print(f"找到 {len(hits)} 条结果")

若能正常输出搜索结果，说明环境配置无误。

内容的提问来源于stack exchange，提问作者zabitstack