rpclib 是一個非常好用的 python webservice 庫，可以動態的生成 wsdl， 不過這個項目已經基本停止，并被一個新的項目取代 spyne，由于舊的項目 工作已經比較穩定，所以我沒有貿然升級到 spyne。

我在 rpclib 編寫 service 方法時，遇到一個奇怪的錯誤： 訪問 wsdl (http://localhost:9898/?wsdl) 頁面，返回 502 Bad Gateway。

在日志中看到如下錯誤信息：

代碼如下:ValueError: All strings must be XML compatible: Unicode or ASCII, no NULL bytes or control characters

我檢查了代碼，對比了之前可以工作的版本，發現并沒有什么不對的地方。

@srpc(RequestModel, _returns=Unicode)def shenzhen(request):  """  根據傳入的token、車牌號及車駕號，以及驗證碼  查詢該車輛的違章記錄  """  logging.info(request)  query = ShenZhenQuery(request)  return query.query_car_records()

但就是沒有正確生成 wsdl，后來我刪除了方法內所有的內容（包括注釋），只留下一條返回 unicode 字符串的語句，然后就工作正常了，但是當我加入了方法的文檔注釋后，又出來了之前的錯誤，于是我 懷疑到了注釋上：中文的注釋，卻沒有使用 unicode 字符串，于是使用 u"" 中文注釋 """ 后，一切正常！

查看生成的 wsdl，發現原來原來 rpclib 使用注釋生成了

代碼如下:<wsdl:documentation>

根據傳入的token、車牌號及車駕號，以及驗證碼 查詢該車輛的違章記錄

代碼如下:</wsdl:documentation>

難怪一遇到中文注釋就會出錯！