Gallery2疑难解答
Gallery2疑难解答的更多链接:Category:Gallery 2:Troubleshooting
需要预先做好的工作
- 清除Gallery缓存!-参见如何清除缓存数据?
- 确保Gallery应用程序文件完好无损!-常见问题:如何确保安装文件完整无损?
- 清除web浏览器缓存(cookies及页面缓存)!
- 启用'buffered'debug模式以确保没有遗漏任何重要警告或详细信息
重要提示: 如果你没有以管理员身份登录的话,你需要启用'buffered'debug模式来检查错误名称及详细信息。参见:常见问题:如何设置/使用Gallery的debug模式?。如果'buffered' debug模式没有任何显示的话,你可以尝试'immediate'或'logged' debug模式。
解决手段...
你可以查找相应特定的'错误名称'来确定遇到的问题,或者在经过分类的症状中对号入座。
错误名称(Error Name)
是不是在访问Gallery首页时就发生了错误?如果错误仅当浏览特定页面/相册时发生或尝试进行某特殊动作时发生的话,你应当先通过错误症状/尝试进行的动作的分类来尝试解决问题(见下表)。
错误名称 |
解决办法
|
ERROR_PLATFORM_FAILURE
|
常见问题:如何修复Gallery存储文件夹文件系统权限问题?
|
ERROR_OBSOLETE_DATA
|
常见问题:如何清除缓存数据?
|
ERROR_REQUEST_FORGED
|
- 登出或清除浏览器cookies并重试。
- 如果你的Gallery被整合在了一个blog,门户或论坛等之中的话,请确保使用的整合是最新版本的。
|
ERROR_STORAGE_FAILURE
|
|
ERROR_BAD_PARAMETER
|
是否自定义/编辑任何模板(.tpl)文件了?或者你是否在使用某第三方外观主题或模块?请尽量避免这种非官方代码所造成的破坏,你可以移除它们(拿外观主题/模块做个例子,只讲它们从modules/和themes/ 文件夹中移除是不够的)。
|
ERROR_LOCK_TIMEOUT
|
参见常见问题:我突然得到了此错误消息"ERROR_LOCK_TIMEOUT",我该怎么办?
|
ERROR_MISSING_ITEM
|
- 如果你尚可访问'站点管理(Site Admin)'部分的话,你应当考虑运行第三方模块,'完整性(integrity)'模块的'完整性检查'。对于G2.2之后的版本来说,它可以在'站点管理(Site admin)' -> '插件(Plugins)'中找到。参见:额外组件的安装。
- 需要做的:为手动修复此类问题的相关指导添加链接。
|
错误症状(Symptom)/尝试性动作(Attempted Action)
请在下面的分类中定位你碰到的问题。请记住,debug模式启用后可以显示更多该问题的相关信息,这与不使用debug模式具有天壤之别。
安装
错误症状/尝试性动作 |
解决办法
|
无法通过验证(第二步)/login.txt
|
参见常见问题:为什么安装程序不接受我的login.txt?
|
系统检查(System Checks)报告了有关'文件完整性'的问题
|
参见常见问题:在安装程序和升级程序中出现的有关文件丢失和被篡改的警告是怎么回事?
|
存储的安装(Storage Setup)(第四步)-创建目录结构错误
|
- 此错误多发生于Windows/IIS服务器。参见Windows Server中的安装
- 如果发生在linux / unix服务器上并且通过FTP客户端确定g2data文件夹的权限为world-writeable(777)的话,请要求你的webhost来查明为何在g2data/中不允许PHP脚本进行文件夹结构的创建。
|
存储的安装(Storage Setup)(第四步)-页面空白/尝试提交时超时
|
如果你在使用G2.1.2的话,请尝试使用G2.2版本。你也该看看有关web服务器错误日志的相关信息。
|
失去对话(Losing Session)/回退到验证步骤
|
如果你在使用G2.1.2的话,请尝试使用G2.2版本(由于2.1版本中相关的cookieless问题)。你也应检查一下PHP的对话设定。你可以通过PHPInfo页面来查看PHP设定,这在此常见问题条目中有解释:常见问题:在论坛寻求帮助时哪些信息是必要的?
|
数据库安装(Database Setup)(第五步)-丢失的/错误的数据库连接信息
|
- 数据库连接信息对每个host来说都是不同的。请询问你的webhost以获取正确的数据库连接信息。
- 此信息一般在网站的管理面板中可以找到(非Gallery的一部分)。
- 许多webhosts在数据库名称和数据库用户名称前添加了一个前缀(如你的帐户名称)。
- 如果不了解'column prefix'和'table prefix'的话,请不要妄加修改。
|
数据库安装(Database Setup)(第五步)-客户端不支持验证协议
|
参见常见问题:为何使用MySQL 4.1或更高版本却不能进行安装?以及常见问题:MySQL错误:"客户端不支持验证协议(Client does not support authentication protocol)"
|
数据库安装(Database Setup)(第五步)-其他的连接问题
|
|
数据库安装(Database Setup)(第五步)-非默认端口(Non-Default Port)
|
如果你需要使用一个非默认端口的话,请将:xxxx后置到主机名(Host Name)之后,如本地主机3307端口就是'localhost:3307'。
|
安装核心模块(Install Core Module)(第八步)失败
|
- 参见常见问题:我在安装的第八个步骤(核心模块的安装)时,遇到了错误。怎么回事?(对于Gallery 2.2以来的版本,我们在系统检查步骤中以对此问题作出了警告)
- 保证PHP memory_limit为16 MB或更高。8 MB往往不是很够。
- 刷新页面或重新进行该步骤是没用的。
- 有时重新运行安装程序可以解决问题。
- 要重试的话,你需要删除存储文件夹,清除数据库并从第四步(或前面的步骤)中重启安装程序,再重复这些步骤。注:为了能够节省些时间,你可以点击左侧的"数据库安装(Database Setup)"步骤的链接,点击"保存(save)",再点击"清除(erase)"。这样你就不用手动删除存储文件夹和数据库了。
|
升级
图片
错误症状/尝试性动作 |
解决办法
|
无法正常生成缩略图或重设尺寸的图片
|
参见常见问题:缩略图/重设尺寸的图片无法正常生成,如何修复?
|
不显示任何图片
|
|
当尝试进行缩略图或重设尺寸图片创建时发生错误
|
先将图片工具包卸载再重新进行安装。详细信息见于:常见问题:缩略图/重设尺寸的图片无法正常生成,如何修复?
|
缩略图(不)呈方(矩)形而不按正常的长宽比显示
|
当'square thumbs'模块处于激活状态时,Gallery就会生成方(矩)形缩略图。Deactivate this module in 在'站点管理(Site Admin)' -> '插件(Plugins)'中禁用此模块(G2.2版本以前为'模块(Modules)')可改变这种状况。若要修改已有的缩略图,你需要对它们进行重建。打开'编辑相册(Edit Album)' -> '相册(Album)'并按照新的设定重建缩略图。
|
尝试查看图片时发生错误
|
是何种错误?参见以下有关'按错误名称解决问题'部分。
|
图片的读取速度太慢
|
- Apache的mod_deflate/gzip没有对二进制文件禁用?
- 服务器CPU,文件I/O或是带宽限制?参见性能调校技巧
|
较大尺寸的图片变形/崩溃
|
- 此问题较罕见。尚无相关的详细信息。我们怀疑是web服务器配置问题或web服务器的bug所致。
- 使用FTP检查g2data/albums/下的文件是否正确。这能帮助你探明是服务器上的文件崩溃还是在向浏览器的传输过程中崩溃的。
|
视频/Flash
错误症状/尝试性动作 |
解决办法
|
显示的是下载链接而不是期望的电影播放器
|
- 是否在'编辑电影(Edit movie)' -> '电影(Movie)'中对视频尺寸进行了设定?Gallery仅显示设定过尺寸(值大于0)的嵌入电影播放器。你可以先在计算机上播放此电影来查看其尺寸(对类似VLC或Windows媒体播放器的电影播放器来说,尺寸的相关信息可在电影属性中找到)。
- 注:如果ffmpeg模块处于激活状态的话,Gallery将会自动检查并为所有的电影设置尺寸(除非你的ffmpeg二进制无法处理某特定的电影格式)。
|
视频无缩略图
|
- ffmpeg模块是否启用了?仅当此模块启用时,Gallery才能够为电影生成缩略图。
- 你的ffmpeg二进制能否处理特定格式的电影?在'站点管理(Site Admin)' -> 'ffmpeg'中科点击'测试(Test)'来看看何种类型的视频可以被正确地处理。
|
无法定位ffmpeg二进制
|
请参考ffmpeg模块获取更详细的信息。
|
电影无法播放
|
参见常见问题:为什么电影无法在我的Gallery中播放了?
|
添加项目/相册/上传
错误症状/尝试性动作 |
解决办法
|
无法进行上传
|
- 要诊断此问题你应当使用'添加项目(Add items)' -> '自浏览器(From browser)'的方法,因为此方法能够提供最详实的debug信息。
- 若PHP上传在你的服务器上完全被禁用的话,在'添加项目(Add items)' -> '自浏览器(From browser)'页面上会有警告提示。同时此页面显示有上传限制。
- 当你尝试上传一个文件时看到了什么?错误吗?
- 确保PHP的upload_tmp_dir配置无误。如果查看你的web服务器日志的话,可能会看到'PHP Warning: File upload error - unable to create a temporary file in Unknown on line 0'这样的错误。这种情况下,upload_tmp_dir不是没有被定义就是web服务器不具备该目录的文件写入权限。其他错误或警告可能是同样情况。
|
无法上传大文件
|
参见常见问题:为何我不能上传大文件(1MB或2MB的文件)?
|
点击上传按钮后出现这样的错误ERROR_STORAGE_FAILURE
|
参见常见问题:添加新相片或创建相册时出现了ERROR_STORAGE_FAILURE的错误,我该怎么办?
|
登录
参见常见问题:I can't login anymore, what can I do?
错误症状/尝试性动作 |
解决办法
|
Login fails with error / warning
|
- Forgot password? (does email not work? Contact admin, admins can use login.txt instead and fix email or reset the user account)
- Do you have any special characters in your password? Prior to Gallery 2.1 this could lead to login problems under certain circumstances. Consider upgrading your Gallery.
- Does it say your user account is "disabled"? (since G2.2) Use the "Forgot Password" link on the login page to reactivate your account.
|
Login fails and just displays a normal Gallery page again
|
- Often clearing the browser cookie cache helps. Check your web-browser settings and clear the cookies for your Gallery website.
- Sometimes, you are actually logged in but still see a page that looks like you are not logged in because your browser did not update its own cache. Please check your web-browser settings and clear the browser cache.
- Is your webserver IIS/5.0 or older and is your Gallery 2 version older than 2.0? We added a workaround for an IIS bug shortly before the official release of Gallery 2.0, you should upgrade your Gallery.
|
工具包/模块的激活
外观主题
模块
翻译/本地化
其他